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FOREWORD 

This  technical  report  covers  work  performed  under  Air  Force 
Contract  F33600-87-C-04 64 ,  DAPro  Project.  This  contract  is 
sponsored  by  the  Manufacturing  Technology  Directorate,  Air  Force 
Systems  Command,  Wright-Patterson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Bruce  A. 
Rasmussen,  Branch  Chief,  Integration  Technology  Division, 
Manufacturing  Technology  Directorate,  through  Mr.  David  L.  Judson, 
Project  Manager.  The  Prime  Contractor  was  Integration  Technology 
Services,  Software  Programs  Division,  of  the  Control  Data 
Corporation,  Dayton,  Ohio,  under  the  direction  of  Mr.  W.  A. 
Osborne.  The  DAPro  Project  Manager  for  Control  Data  Corporation 
was  Mr.  Jimmy  P.  Maxwell. 


The  DAPro  project  was  created  to  continue  the  development,  test, 
and  demonstration  of  the  Integrated  Information  Support  System 
(IISS) .  The  IISS  technology  work  comprises  enhancements  to  IISS 
software  and  the  establishment  and  operation  of  IISS  test  bed 
hardware  and  communications  for  developers  and  users. 

y 

The  following  list  names  the  Control  Data  Corporation 
subcontractors  and  their  contributing  activities: 


SUBCONTRACTOR 


ROLE 


Control  Data  Corporation 


D .  Appleton  Company 


ONTEK 


Simpact  Corporation 


Structural  Dynamics 
Research  Corporation 


Arizi^r.a  State  University 


Responsible  for  the  overall  Common 
Data  Model  design  development  and 
implementation,  IISS  integration  and 
test,  and  technology  transfer  of  IISS. 

Responsible  for  providing  software 
information  services  for  the  Common 
Data  Model  and  IDEFIX  integration 
methodology . 

Responsible  for  defining  and  testing  a 
representative  integrated  system  base 
in  Artificial  Intelligence  techniques 
to  establish  fitness  for  use. 

Responsible  for  Commiunication 
development . 

Responsible  for  User  Interfaces. 
Virtual  Terminal  Interface , and  Network 
Transaction  Manager  design, 
development,  implementation,  and 
support . 

Responsible  for  test  bed  operations 
and  support . 
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SECTION  1 
INTRODUCTION 


This  Network  Transaction  Manager  (NTM)  Development 
Specification  (DS)  provides  the  design  of  the  functions  to  be 
implemented  by  the  NTM  in  the  Integrated  Information  Support 
System  (IISS)  test  bed.  This  specification  supersedes  in  part 
the  NTM  System  Design  Specification.  This  specification  views 
the  NTM  as  a  cohesive,  testable  (stand-alone)  system  with  well 
defined  external  interfaces  between  the  NTM  and  other  test  bed 
configuration  items.  This  document  further  defines  the  operating 
environment,  internal  interfaces,  and  the  database 
characteristics  for  the  NTM.  The  major  emphasis  is  the 
specification  of  the  processing  performed  by  the  NTM. 

The  format  and  content  of  this  specification  is  in 
conformance  with  the  ICAM  Documentation  Standard  (IDS 
150I20000A)  for  a  Development  Specification. 

The  NTM  design  presented  in  this  document  v;as  derived  from: 
(1)  the  NTM  System  Specification,  System  Design  Specification, 
and  Development  Specification  for  project  6201  (2)  technical 
reviev/  meetings  and,  (3)  engineering  judgement.  The  previous 
NTM  Specif icatons  provided  detailed  NTM  requirements.  Technical 
reviev/  meetings  provided  overall  IISS  system  requirements, 
constraints,  and  functional  interface  definitions.  Engineering 
judgement  was  used  to  derive  the  NTM  design  in  consideration  of 
these  factors. 

The  NTM  exernal  and  internal  interfaces  have  been 
established  at  a  functional  level  in  Section  4.1.  Interfaces 
are  identified  between  NTM  and  the  Common  Data  Model  Request 
Processor,  the  User  Interface,  the  Communications  Handler, 
Integrated  and  Nonintegrated  Application  Processes,  and  Host 
Operating  Systems.  The  internal  interfaces  section  defines  the 
NTM  Message  Header  and  the  Monitor  AP  functionality. 

The  emphasis  of  this  document  is  found  in  Section  4.2  v/here 
the  NTM  functions  identified  in  the  IDEF\0  Model  (Appendix  B) 
are  described  as  to  their  inputs,  outputs,  and  processing 
requirements . 

The  NTM  data  characteristics  are  detailed  in  Section  4.5. 
These  are  based  on  the  data  requirements  established  in  the 
earlier  NTM  Specifications.  The  efforts  in  this  area  have 
resulted  in  an  expanded  IDEF\1  data  model  (see  Appendix  C) . 

The  Appendix  to  this  document  provides,  in  addition  to  the 
IDEE  models,  the  data  dictionary  for  the  NTM  data  (Appendix  D) , 
the  definition  of  the  message  types  used  within  the  NTM 
(Appendix  E) ,  and  a  brief  explanation  of  error  message  handling 
within  the  NIH. 
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SCOPE 


2.1  Identification 


This  specification  establishes  the  performance, 
development,  test,  and  qualification  requirements  of  a  computer 
program  identified  as  the  Network  Transaction  Manager, 
hereinafter  referred  to  as  the  NTM.  The  NTM  is  one  configuration 
item  of  the  Integrated  Information  Support  System  (IISS). 

Please  refer  to  the  Software  Availability  Bulletin,  Volume 
III,  Part  16,  Cl?:  SAB620326000,  for  current  IISS  software  and 
documentation  availability. 

2 . 2  Functional  Summary 

The  NTM  Computer  Program  Configuration  Item  (CPCI)  provides 
control  and  support  services  to  application  processes  that  are 
grouped  together  logically  in  clusters  called  Application 
Process  Clusters  (APCs*).  The  sum  of  these  APCs  is  the  IISS.  The 
IISS  is  a  system  that  incorporates  heterogeneous  host  machines 
into  a  network  to  provide  transaction  processing  services  within 
a  manufacturing  environment.  This  environment  is  discussed  in 
the  IDEF\0  model  (contained  in  Appendix  B  below) . 

The  major  functions  of  the  NTM  are: 

a.  Manage  Message :  This  function  provides  for  the  receipt  and 
routing  of  messages  both  between  application  processes 
residing  on  a  cluster  and  between  clusters.  The  message 
manager  also  provides  authorization  checks,  message  and 
error  logging,  and  message  header  completion. 

b.  Manage  Process :  This  function  provides  direct  support  to 
the  application  processes  on  the  cluster  in  terms  of 
initiating  the  process,  communicating  with  the  process, 
enabling  abnormal  termination  or  shutdown,  and  monitoring 
the  process  status. 


*The  term  "Application  Process  Cluster"  (AFC)  replaces  the  term 
"•workstation"  as  used  in  all  previous  NTM  documentation.  In 
concept,  the  two  terms  are  synonomous. 
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c.  Maintain  Operability :  This  function  provides  the  overall 
control  capabilities  of  IISS  system  startup  and  restart, 
recovery,  and  monitoring.  This  function  also  collects  and 
records  status  and  statistics.  This  is  a  system-wide, 
host-wide  and  an  APC  local  function. 
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DOCUMENTS 


3 . 1  Applicable  Documents 

The  following  documents  were  used  in  the  definition  of  the 
NTM  specification. 

3.1.1  Specifications 

[1]  Control  Data  Corporation  and  D.  Appleton  Co.  Inc.;  T ' SS 

Test  Bed  CDM  Needs  Analysis;  June  7,  1982;  IISS  Test 

Bed  CDM  State  of  the  Art ;  June  7,  1982;  IISS  Test  Bed 

CDM  Environment ;  June  7,  1982;  Test  Bed  CDM  System 

Requirements^  June  7,  1982. 

[2]  General  Electric  Co.;  Test  Bed  System  Requirement 
Document  ( Draft) ;  Revised  23  August  1982. 

[3]  I CAM  Computer-Based  Information  System  ( CBIS )  System 
Requirements  Document  ^'Draft);  September  10,  1981;  Cl 
#SRD3101400000. 

[4]  SofTech,  Inc.;  IISS  Test  Bed :  Network  Transaction 
Manager  System  Specification;  May  1982. 

[5]  SofTech,  Inc.;  IISS  Test  Bed :  Network  Transaction 
Manager  System  Design  Specification;  July  1982. 

[6]  General  Electric  Co.;  Test  Bed  System  Specification 
( Draft) ;  23  August  1982. 

[7]  So i Tech,  Inc.;  IISS  Test  Bed :  Network  Transaction 
Manager  Development  Specification  (Mi lestone  I )  ; 

October  1982 . 

[8]  SofTech,  Inc.;  IISS  Test  Bed  Programmer ' s  Guide 
( Dra f t )  ;  January  1983. 

[9]  General  Electric  Co.;  I nterprocess  Process 
Communication  ( I  PC )  Pi imit Ives ;  January  10, 
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3.1.2  Standards 

[10]  American  National  Standards  Committee  X3 ;  American 
National  Dictionary  for  Information  Processing ; 
X3/TR-1-77;  September  1977. 

[11]  I CAM  Documentation  Standards ;  15  October  1983; 
FTR150120000U. 

[12]  SofTech,  Inc.;  I CAM  Test  Bed  Interim  Standards  and 
Procedures" ;  February  1982;  ISP620150000 . 

[13]  General  Electric  Co.;  IISS  Sof tv;are  Development 

Guidel ine/ Convent ions  (Draft) ;  August  23,  1982. 


3.1.3  Other 

[14]  ICAM  Program  Office;  The  Integrated  Sheet  Metal 
Center ;  30  September  1981. 

[15]  ICAM  Program  Office;  The  Role  of  the  ICAM  Test  Bed  and 
Integrated  Information  Support  System  (Draft) ;  18  May 
1982  . 

[16]  SofTech,  Inc.;  IISS  Response  to  CBIS  Requirements  and 
' Threads ' ;  SofTech  Reactions ;  March  18,  1982. 

[17]  Digital;  VAX-11  .Architecture  Handbook;  Digital 
Equipment  Corp. ,  Maynard,  MA,  1985. 

[18]  IBM;  System/370  Principles  of  Operation ,  SA22-7085-0. 

[19]  Digital;  VAX/VMS*  System  Services  Reference  Manual , 
AA-D018B-TE,  "VAX-11  Information  Directory  and  Index," 
AA-D0I6D-TE. 

[20]  Users  Manual:  I DBMS  (2.0)  Users  Manual ,  June  1980. 


*VAX/VMS  IS  a  trademark  of  the  Digital  Equipment  Corporation. 
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[21]  Systems  Users  Manual:  I DBMS  (2.0)  System  Users  Manual , 
June  1980.  IBM;  MVS/Extended  Architecture  Supervisor 
Services  and  Macro  Instructions ,  GC28-1I54-0. 
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REQUIREMENTS 


This  section  includes  functional  and  performance 
requirements  for  the  NTM.  In  addition,  it  defines  the  NTM 
interfaces  to  other  IISS  CPCIs. 

4 . 1  Computer  Program  Definition 

The  NTM  interfaces  v/ith  IISS  CPCIs,  integrated  and 
non-integrated  application  programs  (APs) ,  and  host  operating 
systems.  The  NTM  CPCI  will  interface  v/ith  several  IISS 
components.  The  identified  ones  are:  the  Communications  Handler 
APs  (COMM),  the  Common  Data  Model  Request  Processor  (CDMRP) ,  an 
Operator's  Console,  and  the  User  Interface  (UI). 

4.1.1  System  Capacities 

The  NTM  system  capacity  requirements  are  the  following: 

a.  A  VAX  11/780,  that  runs  the  VMS  Operating  System, 
and  an  IBM  4331  running  MVS.  The  internal  timing 
rates  and  computer  storage  capacities  will  be 
determined  by  the  particular  host's  configurations 
supplied  for  the  IISS  Test  Bed  [14]. 

b.  One  IISS  Operator's  Console  on  each  computer 
system . 

c.  Sufficient  disc  storage  on  all  three  hosts  for  an 
NTM  module,  its  associated  files,  and  a  Message  and 
Error  Log.  Requirements  for  log  archiving  have  not 
yet  been  determined. 


*VAX  is  a  trademark  of  the  Digital  Equipment  Corporation. 
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g- 


There  will  be  three  types  of  inputs  to  the  NTM. 

These  are; 

o  inputs  from  an  operator's  console 

o  messages  and  service  requests  from  other 

CPCIs  and  APs 

o  Host  Operating  System  responses  and 

messages . 

The  volume  of  the  particular  types  of  inputs  has 

not  yet  been  determined. 

The  testbed  NTM  will: 

o  operate  on  the  VAX  11/780,  and  an  IBM  4381 

(Figure  4-1) . 

o  support  COMM,  UI,  MTR  (the  IISS  Monitor  and 

Operator's  Console  Cluster,  Figure  4-2), 
CDMRP,  and  Test  Application  Clusters  on  the 
VAX. 

o  support  COMM,  Monitor,  and  application 

clusters  on  the  IBM. 


4.1.2  Interface  Requirements 

Requirements  placed  on  the  design  of  the  NTM  CPCI  because 
of  its  relationship  to  other  equipment/computer  programs  are  as 
follows.  The  NTM  CPCI  design  is  constrained  by  the  requirement 
to  operate  in  two  environments:  a  VAX  11/780,  VMS  environment; 
and  the  IBM  4381  environment.  It  must  also  provide  message 
acceptance  and  delivery  for  the  other  CPCIs  including  the  IISS 
operator.  Figure  4-1  shows  the  relationships  between  the  hosts 
and  other  CPCIs. 


The  requirement  to  support  the  NTM  on  multiple  hosts 
imposes  a  need  for  portability  in  the  NTM  CPCI  design.  These 
portability  considerations  and  existing  vendor  support  for 
FORTRAN  and  COBOL  effected  a  decision  to  use  COBOL  for  the  IISS 
CPCIs.  There  may  be  a  need  to  use  Assembly  Language  routines  to 
implement  host  specific  functions  that  are  not  available  in 
COBOL.  This  will  only  be  done  v/here  the  COBOL  compiler  does  not 
provide  an  interface  for  host  specific  functions. 
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Notes : 

1.  The  IISS  operator  interface  will  be  implemented  as  an  IISS 
terminal  or  as  a  separate  console  interface.  It  is  treated 
as  a  separate  entitiy. 

2  There  will  be  one  UI  instance  for  each  IISS  terminal  that  is 
logged  on. 

3.  The  Communication  components  are  named  to  indicate  the  link 
pair  (i.e.,  COMM  V-I  indicates  the  component  on  the  VAX  that 
communicates  with  the  IBM) . 

Figure  4-1.  IISS  System  External  Interfaces 
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The  Application  Process  Cluster  (APC)  conceptual 
relationship  to  the  other  CPCIs  is  depicted  in  Figure  4-2.  The 
NTM  rectangles  included  inside  the  heavy  black  rectangle  are  the 
NTM ' s  Message  Processing  Unit  (MPU)  components  for  the 
Application  Process  Clusters  of  the  VAX  host. 

Figure  4-3  focuses  on  the  interface  between  the  MPU 
components  of  the  NTM  and  the  Application  Processes  (APs) .  The 
NTM  provides  an  AP  Interface  (API)  called  the  NTM  I/F  Routine  to 
provide  APs  with  the  ability  to  send  messages  to  other  APs  and 
to  NTM  components  in  the  IISS.  IISS  messages  are  delivered  in 
mailboxes  that  are  managed  by  the  NTM.  The  NTM  uses  IPC 
Primitives  [9]  for  its  interprocess  communication  functions. 
These  Primitives  provide  the  process  to  process  functions  of 
mailbox  creation,  mailbox  writes,  mailbox  reads,  waits,  timers, 
and  mailbox  deletion. 

The  AP  Interface  provides  a  set  of  high  level  NTM  calls  for 
use  by  the  AP  that  are,  in  concept,  similar  to  traditional 
operating  system  calls.  Figure  4-4  contains  a  list  of  these  NTM 
Service  Calls.  A  complete  description  of  the  NTM  calls  is 
contained  in  the  IISS  Programmer's  Guide  [8].  A  set  of  NTM  I/F 
routines  is  linked  to  each  IISS  AP  to  provide  the  integration  of 
the  AP  into  the  IISS  Test  Bed.  The  NTM  interface  requirements 
for  the  NTM  I/F  routines  for  new  APs,  existing  APs,  COMM,  and 
the  UI  are  described  in  the  following  paragraphs.  The  Operator 
Interface  to  the  NTM  requires  a  different  NTM  interface,  and  is 
described  in  Section  4. 1.2.5. 

4. 1.2.1  NTM  Interface  for  New  Applications 

The  NTM  Interface  for  nev;  IISS  Applications  is  the  set  of 
NTM  Services  described  in  the  IISS  Programmer's  Guide  [8].  The 
AP  uses  the  NTM  service  calls  to  send  and  receive  messages  from 
other  IISS  APs.  The  AP  interfaces  directly  to  the  AP  Interface 
component  of  the  NTM  (Figure  4-5).  The  interfaces  will  be 
implemented  as  a  set  of  NTM  I/F  subroutines  that  will  be  bound 
(linked)  to  the  AP  to  form  the  AP's  runtime  module. 
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Fiqure  4-2.  IISS  Architecture  -  Conceptual  Model  on  VAX 
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Figure  4-3.  NTM/AP  Interfaces 
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Connection  Services 

INITAL  Provide  initiation  services  for  new  APs 
TRMNAT  Signal  AP  termination  status 
ENDRCY  Signal  end  of  recovery  processing 

Communication  Services 

NSEND  Send  a  message 

GDSEND  Send  a  guaranteed  delivery  message 

ISEND  Send  an  initiation  request 

QSEND  Send  a  Queue-Server's  reply  message 

CHKMSG  Check  for  any  current  messages  (use  RCV  to 
retrieve  messages) 

SETDLY  Specify  delay  condition  for  next  message 
SIGERR  Notify  the  NTM  of  an  AP  (non-fatal)  error 
GDACK  Acknowledge  receipt  of  a  guaranteed  delivery 
message 

MSGACK  Acknov/ledge  receipt  of  a  message 
RCV  Receive  a  message 

TSTMOD  Switch  IISS  message  test  mode  on  or  off 
NTM  Requests 

APSTAT  Get  the  status  of  a  specified  AP 

HSTATS  Get  the  status  of  a  specified  host 

WHTHST  Request  the  name  of  the  current  host 
WHATAC  Request  the  name  of  the  current  AP  Cluster 
WKONCA  Request  "wake-up"  on  specified  AP  Cluster 
availability 

ACSTAT  Get  the  status  of  a  specified  AP  Cluster 
SIGABT  Signal  to  NTM  to  abort  an  AP 

PRSTAT  Get  the  status  of  one  or  more  paired  messages 

GDSTAT  Get  the  status  of  one  or  more  guaranteed 

delivery  messages 

GETUSR  Get  the  name  of  the  original  source  of  a 
given  chain  of  AP's 

Privileged  Services 

INICOH  Provide  initiation  services  for  the  COMM  APs 
INITEX  Provide  initiation  services  for  UI  AP 
LOGON  Send  IISS  user  Logon  information  to  NTM 
LOGOFF  Send  IISS  user  Logoff  information  to  NTM 
TRMNAX  Signal  Coram  AP  Termination  Status 

Figure  4-4.  NTH  Service  Calls 
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1.  In  implementation,  APs  that  can  process  NTM  commands 
(i.e.,  shutdown)  will  have  three  input  mailboxes.  The 
second  input  mailbox  will  be  used  to  receive  these  high 
priority  unsolicited  messages  from  the  NTM  while  the 
third  is  reserved  for  Message  Acknowledgements  from  the 
NTM. 


Figure  4-5.  The  AP's  Interface 
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An  AP  that  is  to  be  integrated  into  the  IISS  and  use  the 
message  services  of  the  NTM  must  be  written  according  to  a 
format  that  includes  NTM  Initiation  (INITAL)  and  termination 
(TRMNAT)  calls  at  the  beginning  and  the  end  of  irs  Procedure 
Division  (COBOL)  as  shov/n  in  Figure  4-6.  The  CALL  "INITAL"  and 
CALL  "TRMNAT,"  respectively,  provide  the  IISS  connection  and 
termination  service.  Communication  between  IISS  APs  is 
accomplished  by  using  the  NTM  calls  that  are  described  in 
Section  6  of  the  IISS  Programmer's  Guide  [8].  For  example,  the 
CALL  "NSEND"  USING  ...,  will  cause  a  program's  message  to  be 
delivered  to  the  NTM  for  routing.  The  NTM  routes  the  messages 
through  the  IISS  to  the  destination  AP.  The  destination  AP 
receives  its  messages  by  using  the  NTM  "RCV"  call. 

4 . 1 . 2 . 2  NTM  Interface  for  Existing  Applications 

An  NTM  interface  for  existing  applications  may  be  designed 
to  minimize  any  reguired  changes  to  the  APs  for  interfacing. 
Rules  for  the  NTM  interface  for  integrating  existing  Cobol  APs 
are : 

a.  The  AP  shall  include  an  initiation  routine  'INI - ' 

that  may  be  specific  to  each  application.  It  will 
provide  NTM  connection  logic  for  the  AP. 

b.  The  AP  will,  in  some  manner,  take  I/O  from  the 
program's  DISPLAY  call  and  formulate  an  NTM  message 
from  the  data  and  deliver  it  to  a  User  Interface  AP 
(UI)  for  display  on  a  non-local  terminal  request. 

c.  The  AP  will  receive  a  message  from  a  UI  for  the 
application  and  unpack  the  received  data  to  return 
to  the  program  in  place  of  its  ACCEPT  statements. 

d.  The  AP  shall  include  a  termination  routine  "TRM - " 

that  v;ill  disconnect  the  .AP  from  the  NTM. 

Since  the  Rapid  Application  Generator  is  capable  of 
quickly  generating  a  fully  integrated  IISS  AP,  it 
v/ould  be  a  very  unusual  case  that  v.'ould  benefit  by 
this  technique  of  integrating  an  existing 
appl ica t ion . 
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AP  PROGRAM 

PROCEDURE  DIVISION. 

CALL  "INITAL"  USING  BUFFER, 

BUFFER-SIZE, 

SYSTEM-STATE, 

RET-CODE. 

AP  CODE:  can  include  NTM  calls  that  are 

described  in  the  IISS  Programmer's 
guide  [8]  to  communicate  with  the 
IISS. 

CALL  "TRMNAT"  USING  TERMINATION-STATUS.* 

*CALL  "TRMNAT"  is  the  last  statement  in  the  AP. 

Figure  4-6.  IISS  AP-COBOL  Procedure  Division  Structure 
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4 . 1 . 2 . 3  NTM  Interface  to  the  COM  AP's 

The  Communication  (or  COMM)  AP  cluster  v;ill  support  a  COMM 
application  process  for  each  host  connection.  They  are  handled 
in  a  slightly  different  manner  from  other  AP's.  These 
differences  are  noted  below.  The  COMM  AP  cluster  on  the  VAX  host 
is  conceptually  represented  in  Figure  4-7.  These  COMM  AP's  are 
not  part  of  the  NTM. 

Because  the  COMM  APs  perform  many  of  the  AP  Interface 
functions  directly,  they  will  have  only  a  selected  set  of  AP 
Interface  routines  bound  to  them. 

The  NTM  Interface  for  the  COMM  APs  is  the  following: 

Services 

a.  COMM  will  use  the  NTM  initiation  routine, 

CALL  "INICOM"  USING  event-block, 

input-mai 1 box -name , 
cluster-hot-mailbox  name, 
cluster-cold-mailbox  name, 
status . 

INICOM  will 

o  create  the  COMM's  input  mailbox 

o  establish  an  IISS  exception  handler  for  COMM 

o  return  tiie  names  of  the  COMM  AP's  input 

mailbox  and  the  names  of  the  two  cluster 
mailboxes . 

b.  COMM-NTM  Communication  -  The  COMM  AP's  v;ill  use, 
directly,  the  IPC  primitives,  to  send  and  receive 
messages  from  the  NTM.  On  receiving  a  message  from 
the  NTM  it  will  inspect  the  destination  AP  name  in 
the  header  to  determine  whether  the  message  is  for 
it  or  to  be  sent  to  its  remote  host.  Messages  for 
COMM  and  the  COMM-NTM  protocol  are  given  in  Figure 
4-3  . 

c.  COMM  will  use  the  NTM  termination  routine,  "TRMN.^T" 
[8],  to  end  its  execution.  It  calls  "TRHNAT"  on  the 
receipt  of  a  "TR"  mess^ige  from  the  NTMs  MONITOR  AP. 


4-11 


DS  620342000 
30  September  1990 


local  area  net  link  network  link 

to  Honeywell  Le«el  6  to  IBM 


Figure  4-7.  The  COMM  AP/NTM  Interface 


4-12 


DS  620342000 
30  September  1990 


Message  to  a  COMM  AP 
from  the  NTM ' s  Monitor  AP 

Message  Types 

a)  "SL"  (start  link) 


b)  "SD"  (shutdown  link) 

c)  "TR" 

d) 


Figure  4-8.  COMM 


Action  by  the  COMM  AP 


COMM  attempts  to  start  the 
link  to  its  remote  host. 
Responds  v;ith  "LA"  -  link 
activ'e  message  or  "LF"  - 
link  fail 


COHM  shuts  down  (stops 
listening  to)  remote  host 
and  responds  with  "LF" 


COMM  calls  the  NTM 
termination  routine 
"TRMNAT"  to  end  execution 


A  COMM  may  send  the 
folloiving  unsolicited 
messages  to  the  NTM's 
MONITOR  AP. 

"RE",  recoverable  error 
with  five  character  error 
code  in  the  data  field 

"LF",  a  link  fail  message 


AP/NTM  Protocol 
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4 . 1 . 2 . 4  NTM  Interface  to  the  User  Interface  (UI) 

The  User  Interface  (UI)  is  the  application  process  that 
interfaces  to  the  IISS  user  terminals.  Initially,  there  will  be 
one  UI  per  IISS  terminal  with  a  number  of  UIs  associated  with 
one  work  station.  Conceptually,  the  NTM-UI  Interface  is  depicted 
in  Figure  4-9. 

The  connection  protocol  of  these  terminals  causes  this  APC 
to  be  handled  in  a  slightly  different  manner  than  other  APCs . 
However,  this  difference  is  transparent  to  the  UI  APs .  The  UI 
(AP)  Interface  and  the  NTM  protocols  handle  this  special 
requirement  by  providing  the  necessary  NTM  connection  logic  on 
the  UI's  initiation  call,  CALL  "INITEX"  [8].  The  services  of 
INITEX  are  described  belov;.  This  implementation  is  specific  for 
the  VAX  under  VMS . 

UI-NTM  Initiation  Service  (INITEX) 

The  UI  requires  an  "external"  initiation  connection  service 
that  is  supplied  by  the  routine  "INITEX."  This  allows  a  user  to 
logon  to  an  IISS  terminal  and  initiate  a  UI  process  from  a  logon 
command  file.  The  UI  must  connect  to  the  NTM,  rather  than  the 
NTM  initiating  the  UI  as  in  the  normal  IISS  process  initiation 
procedure.  External  connection  is  required  in  light  of  the  way 
that  the  UI  will  manage  the  terminals.  INITEX  performs  the 
following  initiation  functions  for  the  UI. 

1.  Sends  an  "I'm  alive"  message  that  contains  the  UI's 
operating  system  given  process  name  to  the  UI's 
NTM. 

2.  Creates  the  UI's  input  mailboxes. 

3.  Establishes  the  IISS  exception  handler  for  the  UI. 

4.  Saves  the  UI's  buffer  address  and  buffer  size  for 
later  message  services. 

5.  Returns  to  the  UI  with  the  status  of  the 
initiation . 

The  UI  and  Logical-Channels 


A  UI  will  manage  communications  betv/een  the  NTM  and  any 
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1.  UI  represents  the  UI  code. 

UI  (AP)  Interface  is  the  special  AP  Interface  for  the  UI. 
The  UI  code  is  bound  with  the  UI  (AP)  Interface. 

2.  The  UI-1  Mailbox  is  the  Input  mailbox  for  the  first 
instance  of  the  UI. 

3.  These  represent  the  work  stations  high  and  low  priority 
mailboxes . 

4.  The  MPU  is  the  Message  Processing  Unit  of  the  NTM. 


Figure  4-9.  NTM-UI  Interface 
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terminals  connected  to  it.  The  logical  channel  specifier 
provides  a  mechanism  for  the  UI  to  map  messages  to  terminals,  or 
to  multiple  screens  on  a  given  terminal.  The  UI  can  manage  the 
mapping  between  messages  and  screens  or  terminals  by  maintaining 
a  table  that  carries  the  current  channel  assignments  for  a 
terminal  or  screen  and  using  the  channel  numbers  as  suggested  in 
[8]  . 


The  reguirement  for  an  AP  to  be  able  to  send  an  unsolicited 
form  to  a  terminal  can  be  supported  by  the  use  of  a  specified 
channel  for  UI  unsolicited  messages  (channel  0  is  being  reserved 
for  these  unsolicited  messages  for  single-terminal  UIs) . 

Multiterminal  UIs  are  queue  servers  and  are  supported  by 
the  NTM.  The  UI  will  assign  blocks  of  channel  specifiers  to  a 
terminal  when  the  terminal  logs  on.  The  NTM  will  need  to  know 
the  channel  numbers  associated  with  a  logon,  and  will  provide  a 
message  format  for  this  data  when  mult iterminal  UIs  are 
developed . 

UI-NTM  Interface  Programming  Conventions 


The  UI  must  use  the  following  guidelines  to  communicate 

successfully  in  the  IISS  Test  Bed. 

1.  It  must  be  bound  with  the  UI  (AP)  Interface  supplied  by 
the  NTM. 

2.  It  must  initiate  communications  with  the  NTM  with  a  'CALL 
"INITEX"  USING. . . 

3.  It  must  support  asynchronously  received  (unsolicited) 
messages  using  CALL  "RCV"  or  CALL  "CHKMSG"  and  CALL  "RCV" 
at  regular  intervals. 

4.  It  must  handle  "shutdown"  messages,  including  shutdown 
pending,  cancel  shutdown,  and  its  ov/n  shutdown  procedures. 

5.  If  the  IISS  is  in  a  recovery  or  down  state,  the  UIs  will 
get  a  "connection-failure-reason"  status  return  on  the 
CALL  "INITEX."  It  should  inform  the  terminal  of  the  state 
of  the  IISS  and  provide  a  logoff  or  local  mode  capability 
to  the  user. 

6.  It  must  use  the  NTM  Service  Calls  [8]  to  communicate  with 
other  IISS  APs. 

7.  It  should  terminate  with  the  NTM  call,  "TRMNAT" . 
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4 . 1 . 2 . 5  NTM  Interface  to  the  IISS  Operator 

The  NTM  shall  interface  to  an  IISS  Operator's  Console. 
Initially,  the  interface  will  exist  only  on  the  VAX  and  will  be 
implemented  as  a  direct  link  from  the  operator's  console  to  the 
NTM ' s  Monitor  AP  (Figure  4-10).  An  early  enhancement  will  be  an 
IISS  Operator's  Interface  through  a  UI  to  enable  the  use  of 
forms  and  screen  displays  by  the  IISS  Operator. 

a.  The  initial  test  bed  shall  support  the  following 

IISS  Operator  Commands  during  IISS  operation. 


1. 

Start  IISS 

2  . 

Start  APC 

3  . 

Start  Link 

4  . 

Shutdown  APC 

5. 

Shutdown  IISS 

6. 

Cancel  IISS  Shutdown 

7  . 

Display  Active 

APs 

8  . 

Display  IISS  Status 

9  . 

Enable  SIGERR 

Messages 

10  . 

Disable  SIGERR 

Messages 

The  MONITOR  shall  provide  prompts  to  the  operator  to  obtain 
the  data  required  for  each  command.  For  example,  the  following 
is  the  START  LINK  scenario  on  the  VAX. 

>  SL 

Enter  Link  ID: 

>  VI 

(Terminal  Locked  out  during  command  Execution) 

COMM  LINK  VI  IS  ACTIVE. 

>  (a  new  command  may  nov/  be  entered) 

b.  NTM  status  information  sent  to  the  MONITOR  AP  from  any 
of  the  MPU ' s  that  may  require  an  operator's  action 
shall  be  displayed  on  the  operator's  console. 

c.  For  the  initial  test  bed,  the  IISS  is  started  by  a 
START  IISS  command  entered  by  an  operator  on  each  IISS 


Operator's  Entry 
Monitor  Prompt 
Operator's  Entry 
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Figure  4-10.  IISS  Operator's  Interface 
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host.  The  START  lISS  command  v/ill  initiate  a  command 
file  that  starts  the  MONITOR  AP  on  each  host.  The 
MONITOR  APs  then  startup  the  other  NTM  modules  and 
APCs  on  their  hosts  and  cooperate  to  connect  the  other 
IISS  hosts  to  complete  the  startup. 

4.1.3  Internal  NTM  Interfaces 


Three  components  (Monitor,  MPU,  and  AP  Interface) 
communicate  among  themselves  through  mailboxes  via  well  defined 
messages.  These  messages  have  been  defined  by  type  and  are 
thoroughly  defined  in  Section  10.5.  Each  message  carries  a 
header  and  an  optional  data  portion.  The  header  provides  the 
essential  processing  information  needed  by  the  destination 
component.  The  data  portion  is  reserved  for  specific  backup 
information  pertinent  to  the  relevant  message  type. 

Field  Name  Field  Size  Field  ID 


Header  Format  Indicator 

X 

HDR-HDRFMT 

Header  Length 

X(3) 

HDR-HDRLEN 

Data  Length 

X(4) 

HDR-DATLEN 

Binary/Native  Flag 

X 

HDR-BINNAT 

Message  Priority 

X 

HDR-MSGPRY 

Message  Type 

X(2) 

HDR-MSGTYP 

AP  Name  (Destination) 

X(10) 

MD-APNAME 

Instance  (Destination) 

X(2) 

MD-INSTNC 

APC  Name  (Destination) 

X(3) 

MD-APCNME 

AP  Name  (Source) 

X(10) 

MS-APNAME 

Instance  (Source) 

X(2) 

MS-INSTNC 

APC  Name  (Source) 

X(3) 

MS-APCNME 

Message  Serial  Number 

X(7) 

HDR-MSGSN 

Processing  Code 

X 

HDR-PROCDE 

Message  Category 

X 

HDR-MSGCAT 

AP  Priority 

X 

HDR-APPRTY 

Integrity  Check  Flag 

X 

HDR-INTCHK 

Log  Requirement 

X 

HDR-LOGREQ 

Statistics  Collection  Flag 

X 

HDR-STATCO 

Test  Flag 

X 

HDR-TSTFLG 

Delay  Trigger  Flag 

X 

HDR-DELTRG 

Delay  Tim.e  Trigger 

X(15) 

HDR-TRGTIM 

Delay  Trigger  Condition 

X 

HDR-TRGCON 

Original  Source 

X(15) 

HDR-ORGSRC 

Logical  Channel  ID 

X(3) 

HDR-CHANID 

Continuation  Indicator 

X 

HDR-CONIND 

Figure  4-11.  Header  Format 
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4. 1.3.1  Message  Header 

The  message  header  carries  the  relevant  information  about 
the  message  throughout  the  NTM.  The  header  is  formatted  by  the 
AP  Interface  at  the  message  source  AP.  The  MPU  fills  in  the 
field  values  it  is  responsible  for  and  performs  the  integrity 
checks  on  the  other  header  fields.  The  completed  header  stays 
with  the  message  until  it  reaches  its  destination.  The  Header 
Format  is  shown  in  Figure  4-11.  Each  field  is  defined  below. 


Field  Name 

Field  Value 

Supplied  By 

Field  Description 

Header  Format 

AP  Interface,  MPU 

Identifies  the 

Indicator 

or  Monitor  AP 
(depending  upon 
the  source  of  the 
message) 

particular  format 
of  the  given  message 
header.  For  the  test 
bed  there  is  only  one 
format  although  future 
enhancements 
may  require  other 
formats.  The  value 
contained  in  this 
field  maps  to 
its  definition  in 
the  Data  Division. 

Header  Length 

AP  Interface,  MPU 
or  Monitor  AP 
(based  on  Header 
Format) 

Identifies  the  length 
of  the  given  header 
format.  The  value 
is  given  as  number  of 
bytes . 

Data  Length  Message  Source  AP  Identifies  the  length 

(may  be  any  AP  on  of  the  data 

the  IISS  including  portion  of  the 

Monitor  and  an  MPU)  message. 

The  value 

is  given  as  number  of 
bytes . 

Binary/Native  Message  Source  AP  Indicates  whether  the 

Flag  (or  default)  data  portion  of  the 

of  the  message  is 


4-20 


DS  620342000 
30  September  1990 


Field  Value 
Field  Name  Supplied  By 


Field  Description 


Message 

priority 


Message  Type 


AP  Name 
( Destination) 


Instance 
( Destination) 


A PC  Name 
( Destination) 


Source  MPU  (based 
on  Message  Category) 


Message  Source  AP 

(Note:  This  value 
cannot  be  derived 
-  it  can  only  be 
provided  by  the 
source) 


Message  Source  AP 
(Note:  This  value 
cannot  be  derived, 
it  can  only  be  pro¬ 
vided  by  the  message 
source . ) 

AP  Interface  (Note: 
this  field  is  op¬ 
tional,  as  a  desti¬ 
nation  instance  may 
not  exist  v/hen 
message  is  sent.) 

Source  MPU 


encoded  in  binary  or 
native  mode.  The 
default  value  on  any 
message  is  always  to 
native  mode. 

Identifies  the 

priority 

of  the  message. 

The  value  is  obtained 
by  the  MPU  from  the 
Message  Category 
Table . 

Identifies  the 
nature  of  the  message. 
See  Section  10.5  for 
specific  message  types 
used  by  the  NTM. 

The  Source  AP  is  free 
to  choose  it ' s  own 
message  types  as 
defined  by  AP-AP 
protocol . 

Identifies  the 
Application  Pro¬ 
cess  to  which  the 
message  is  directed. 


Identifies  the 
specif ic 

occurence  of  the  Des¬ 
tination  AP  to  which 
the  message  is  the 
directed,  when  known. 

Identifies  the  AP 
Cluster  upon  which 
the  destination  AP 
resides.  This  value  is 
generally  obtained 
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Field  Value 
Field  Name  Supplied  By 


Field  Description 


AP  Name  (Source) 
Instance 

occurrence  (Source) 


AP  Interface 

AP  Interface 


APC  Name  AP  Interface 

(Source) 

Message  Source  MPU 

Serial  # 


from  the  AP 

Information  Table.  The 
exceptions  are  in  the 
cases  where: 

a.  The  Destination  AP 
is  an  IISS  Component 
(whose  APC  Names  are 
known  to  all  MPU's) 

b.  The  Destination  AP 
is  an  MPU. 

c.  The  source  AP  has 
received  a  message 
from  the  destination 
and  therefore  knows 
the  destination  APC. 

The  source  of  the 
given  message. 

The  specific 

of  the  message  source 

AP. 

The  APC  upon  which  the 
source  AP  resides. 

A  number 
that,  when 

concatenated  with  the 
source  APC 
name,  provides  a 
unique  message 
identifier  for  the 
given  message  through¬ 
out  the  IISS. 
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Field  Name 


Processing  Code 


Message  Category 


AP  Priority 


Integrity  Check 
Flag 


Log  Requirement 


Statistics 
Collection  Flag 


Field  Value 

Supplied  By  Field  Description 


AP  Interface  or 
Default 


AP  Interface  (de¬ 
rived  from  Call 
'SEND'  Parameters) 


Source  MPU 


Message  Source  AP 
or  Default 


Source  MPU 


Source  MPU 


Identifies  whether  the 
given  header  is  "used" 
or  new.  If  "used"  it 
is  assumed  to  be 
correct  and  does  not 
require  integrity 
checking.  The  default 
is  always  set  to  "0" 
(new)  . 

Defines  special 
processing 

to  be  performed  by  the 
MPU.  See  Sections 
4. 5. 3.1  and  Appendix  E 
for  details. 

Identifies  the 
relative  priority  of 
the  source  AP.  Its 
value  is  obtained  from 
the  AP  Characteristics 
Table . 

Indicates  whether  an 
integrity  check  is  to 
be  performed  on  the 
data  portion  of  the 
message.  The  default 
is  always  set  to  "0" 
(No)  . 

Indicates  whether  the 
message  is  to  be 
logged  at  every  MPU  it 
arrives  at.  The  value 
is  obtained  from  the 
Message  Category 
Table . 

Indicates  whether 

statistics  are 

to  be  collected  on  the 
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Field  Name 


Test  Flag 


Delay  Trigger 
Flag 


Delay  Trigger 
Time 


Delay  Trigger 
Condition 


Original  Source 


Field  Value 

Supplied  By  Field  Description 


Message  Source  AP 


Message  Source  AP 
or  Default 


Message  Source  AP 
or  Default 


Message  Source  AP 
or  Default 


AP  Interface 


message.  The  value  is 
obtained  from  the 
Message  Category 
Table . 

Indicates  whether  the 
source  AP  is  operating 
in  regular  or  test 
mode.  If  in  test  mode, 
this  flag  provides  a 
warning  to  the 
destination  AP  to 
handle  the  message 
accordingly . 

Defines  when  the  Flag 
message  is  to  be 
delivered  to  its 
destination  AP.  The 
default  is  always  set 
to  "0"  (No  Delay) . 

Identifies  the  time 
constraint  associated 
with  the  delay 
trigger.  Where  a  time 
constraint  is 
not  applicable,  this 
field  will  be  filled 
with  blanks  (default) . 

Identifies  the  condi¬ 
tional  constraint 
associated  with  the 
delay  trigger.  Where 
this  constraint  is  not 
applicable,  the  field 
will  be  filled  with 
blanks  (default) . 

Identifies  the 
Original  Source  (root 
AP)  of  the  Message 


4-24 


DS  620342000 
30  September  1990 


Field  Value 
Field  Name  Supplied  By 


Field  Description 


Logical  Channel 
ID 


Source  AP.  This  value 
is  generally  obtained 
from  the  AP  Status 
Table.  The  exception 
is  for  messages 
conforming  to  Category 
F.  In  that 
case,  the  value  is 
obtained  from  the 
corresponding  field  of 
the  relevant  Category 
B,  D,  or  J  message. 

See  Appendix  E  for 
details  on  the  use  of 
Category . 


Original  source  AP  On  messages  conforming 
AP  or  the  AP  Inter-  to  Category  b,  D,  or  J 
face  the  logical  channel  ID 

identifies  the  channel 
upon  which  the  reply 
message  is  to  be 
returned.  (Note:  the 
channel  will  either  be 
source  specified  or 
defaulted  to  the 
channel  under  which 
the  source  AP  was  ini¬ 
tiated)  .  On  Category  H 
messages,  this  field 
will  contain  the 
channel  ID  under  which 
the  target  AP  is  to  be 
initiated.  On  Category 
F  messages,  this  field 
will  contain  the 
channel  ID  specified 
in  the  original  B,  D, 
or  J  message  (i.e., 
the  Field  request 
message  to  which  the 
reply  is  being  made) . 
For  A,  C,  E  or  G 
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Value 

Field  Name  Supplied  By 


Field  Description 


messages,  the  channel 
ID  value  will  be  the 
one  under  which  the 
message's  source  AP 
was  initiated. 

The  source  AP's 
channel  ID  is  obtained 
from  the  AP  status 
table.  See  Appendix  E 
for  details  on  the  use 
of  Category. 

Continuation  AP  Interface  Identifies  whether  the 

Indicator  message  is  continued 

or  stand  alone. 

4. 1.3. 2  The  Monitor  AP 

The  Monitor  AP  (Figure  4-12)  is  a  component  of  the  NTM 
that  resides  on  each  IISS  host  on  a  cluster  that  is  dedicated  to 
this  AP.  It  is  an  IISS  Application  Process  whose  functions  are 
illustrated  in  the  node  tree  in  Figure  4-12. 


Figure  4-12.  Monitor  AP  Functions 
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4 . 1 . 3 . 2 . 1  Accept  Commands  from  the  IISS  Operator 

The  commands  that  will  be  accepted  from  the  Operator's 
console  in  the  initial  Test  Bed  are  listed  in  4. 1.2.5. 


4 . 1 . 3 . 2 . 2  Service  Commands  from  the  IISS  Operator 

The  processing  that  is  provided  on  each  of  the  supported 
IISS  operator's  commands  is  described  below. 


START  IISS  ON  VAX: 


1  . 


3  . 

4  . 

5  . 


6  . 


7  . 


10  . 


Monitor  AP  is  spaw'ned  as  a  result  of  the  start  IISS 
command  from  the  operator. 

Monitor  reads  its  startup  file  to  determine  the  current 
Sysgen  Parameters.  Among  the  parameters  is  the  current 
table  configuration.  Monitor  compares  the  current 
Operating  configuration  ID  to  its  old  value  and  sets  a 
flag  that  indicates  v;hether  tables  and  local  files  are 
up-to-date . 

Monitor  creates  its  input  mailbox. 

It  spawns  it's  APC ' s  MPU . 

It  waits  for  a  "Table  Status  Request"  message  from  the 
spawned  MPU. 


On  receipt  of  the  "Table  Status  Request"  message,  the 
Monitor  alv;ays  sends  a  "Tables  OK"  message  to  its  MPU  and 
then  v.’aits  for  an  "I'm  Alive"  message  from  the  MPU.  (The 
Monitor  MPU ' s  tables  will  be  corrected  after  the  CDM 
cluster  is  up,  if  necessary). 

On  receipt  of  the  "I'm  Alive"  message,  the  Monitor  updates 
the  Monitor's  APC  status  in  the  APC  Status  Table  to 
"cluster-up" . 


Monitor  sends  the 
indicate  that  the 
normal  processing 


active  APC  a  "Host  Active"  message  to 
ARC'S  startup  is  complete  and  it's 
can  begin . 


The  Monitor  AP  spav/ns  the  CDM  cluster  by  sending  a  'start 
APC'  message  to  its  MPU  whicli  will  now  spawn  the  CDM  MPU. 
It  now'  repeats  steps  5-7  for  the  CDM  cluster,  except  it 
w'ili  now  send  the  correct  table  status  to  the  CDM  cluster 
(Tables  OK  or  Tables  Obsolete)  . 


If  rhe  current  table  configuration  ID  is  not  equal  to  the 
old  ID,  the  Monitor  AP  sends  requoL.ts  for  new  tables  to 
the  CDMRP  and  then  sends  a  "Rebuild  Table"  message  to  its 
MPU  so  that  the  MPU  can  rebuild  the  tables. 


11.  If  any  of  the  above  steps  encounters  an  unrecoverable 

error,  the  Monitor  AP  will  send  a  message  to  the  operator 
and  end  execution. 
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12.  The  Monitor,  now  with  correct  tables,  sends  a  'START  ARC 
message  to  its  MPU  to  startup  the  UI  cluster  (then,  does 
Steps  5-8  again,  sending  the  correct  table  status) .  If 
this  fails,  the  Monitor  AP  informs  the  operator  and 
terminates  the  IISS. 

13.  Other  clusters,  indicated  by  the  Monitor  AP ' s  tables,  are 
started  by  a  "start  APC"  message  followed  by  Steps  5-8. 
This  time,  however,  a  failure  only  causes  a  status  message 
to  be  sent  to  the  operator  and  an  update  to  the  Monitor 
AP's  Status  Tables. 

14.  The  Monitor  AP  next  starts  the  Network  Communications  by 
sending  Initiate  COMM  AP  messages  to  the  COMM  cluster. 
These  are  followed  by  Start  Link  messages  to  the  COMM  APs. 
The  link  status  message  will  be  received  and  handled  as 
part  of  Monitor's  regular  processing  operations. 

15.  The  Monitor  AP  updates  its  Host  table  entry  to  Auiive. 
"Host  Available  Messages"  that  include  the  host  active  APC 
names  will  be  sent  to  any  remote  hosts  once  a  link  is 
established  v;ith  the  VAX. 

START  IISS  ON  NON-VAX  HOSTS; 

1.  It  is  assumed  that  non-VAX  startups  will  be  initiated  at 
the  system  operator's  console. 

2.  Steps  1-6  of  the  VAX  startup  are  performed. 

3.  The  link  to  the  VAX  is  started  as  in  Step  14  with  only  one 

difference:  the  Monitor  AP  will  always  send  a  "Tables  OK" 

message  to  the  COMM  MPU.  If  this  is  unsuccessful,  the 
non-VAX  startup  has  failed,  a  status  message  is  sent  to 
the  non-VAX  console,  and  the  host  startup  is  terminated. 
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4.  If  the  link  to  the  VAX  is  successful  and  the  Non-VAX 
MONITOR  receives  the  "VAX  Host  Available"  message  sent  in 
step  15  above,  the  Non-VAX  MONITOR  AP  rebuilds  its  tables 
and,  if  necessary,  sends  rebuild  table  messages  to  the 
MONITOR  and  COMM  MPUs.  (The  MONITOR  AP  and  the  MPU ' s  use 
of  the  off-host  table  rebuild  protocol  is  TBD) . 

5.  If  host  tables  were  rebuilt  from  the  COM,  the  MONITOR  AP 
waits  for  "Table  Rebuilt"  Status  messages  from  the  COMM 
and  MONITOR  AP  MPUs. 

If  table  processing  fails,  the  MONITOR  AP  informs  the 
operator  and  terminates  the  IISS  component  on  the  non-VAX 
host , 

6.  When  the  non-VAX  NTM  tables  are  built,  the  local  APCs  to 
be  initiated  are  started  as  they  are  on  the  VAX.  An 
initiation  error  here  is  not  a  fatal  IISS  error, 

7.  The  remaining  network  links  are  started  and  "Host 
Available"  messages  are  sent  as  in  Step  15  of  the  VAX 
Startup . 


START  APC  (VAX  only,  while  IISS  is  running) : 

1.  Monitor  prompts  the  Operator  for  the  APC  name. 

2.  The  operator  enters  an  APC  selection. 

3.  If  the  selection  is  valid,  the  Monitor  AP  determines  the 
host  location  of  the  APC. 

4.  If  the  APC  is  off-host  and  the  destination  host  is 
running,  the  MONITOR  AP  sends  a  "START  APC"  command  to  the 
correct  off-host  Monitor  AP  MPU.  If  the  host  is  not 
active,  the  Monitor  AP  sends  a  "APC's  Host  is  not  active" 
message  to  the  operator. 

5.  If  the  APC  is  on-host,  the  Monitor  AP  sends  a  'START  APC 
command  to  its  MPU  and  performs  the  protocol  of  Steps  5-8 
in  the  IISS  Startup  Procedure  (p.  4-27). 


START  LINK  (VAX  only  v,?hile  IISS  is  running)  : 

1.  Monitor  prompts  the  Operator  for  a  link  ID. 

2.  The  operator  enters  a  link  ID. 

3.  If  the  selection  is  valid,  the  monitor  AP  checks  to  see  if 
the  COMM  APC  is  available,  if  it  is  not: 

3a.  It  sends  a  "Start  COMM  APC"  message  to  its  MPU 

3b.  The  Monitor  checks  the  status  of  the  COMM  AP. 
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3c.  If  the  COMM  AP  is  not  active,  the  MONITOR  then 
sends  a  "Start  Comm  AP"  Message  followed  by  a 
"Start  Link"  message  to  the  COMM  AP.  If  the  COMM 
AP  is  active,  only  the  "Start  Link"  message  is 
sent . 

3d.  Upon  receiving  the  link  status  from  the  COMM  AP, 

the  MONITOR  AP  displays  the  new  link  status  to  the 
operator. 

If  the  COMM  APC  is  available.  Steps  3b,  3c,  and  3d  are 
performed . 


SHUTDOWN  APC  (on  VAX  only)  ; 

1.  The  MONITOR  prompts  the  Operator  for  the  APC  name. 

2.  The  operator  enters  the  APC  name. 

3.  If  the  selection  is  valid,  the  operator  sends  a  "SHUTDOWN 

APC"  message  to  the  APC. 

4.  On  a  Shutdown  Status"  message  from  a  VAX  APC  or  an  "Update 
APC  Table"  message  from  a  non-VAX  Monitor  AP  if  the  APC 
was  off  host,  the  Monitor  AP  sends  a  status  update  message 
to  the  operator. 


SHUTDOWN  IISS  (on  VAX  only) : 

1.  The  MONITOR  AP  requests  the  time  until  shutdown  from  the 
operator . 

2.  If  the  time  until  shutdown  is  not  immediate,  the  MONITOR 
AP  sends  "Shutdown  Pending"  status  message  to  the  UIs  at 
one  minute  intervals.  If  shutdown  is  immediate  step  3  is 
ignored . 

3.  Before  the  time  until  shutdown  expires,  the  MONITOR  AP 
will  accept  only  "CANCEL  IISS  SHUTDOWN,"  DISPLAY  IISS 
STATUS",  "HELP",  or  "DISPLAY  ACTIVE  APs"  commands  from  the 
operator . 

4.  When  the  time  until  shutdown  has  elapsed,  the  VAX  MONITOR 
AP  sends  "SHUTDOWN  IISS"  messages  to  the  non-VAX  MONITOR 
APs,  sets  its  status  to  "IISS  Shutting  Down",  and  sends 
"SHUTDOWN  APC"  messages  to  each  active  on-host 
non-component  APC. 

5.  Each  non-VAX  Monitor  AP  on  receiving  the  Shutdown  Command 
sends  "Shutdown  APC"  messages  to  its  APCs  (except  COMM) . 
When  all  of  the  APCs  "APC  Shutdown"  messages  have  been 
received,  the  non-VAX  Monitor  AP  sends  a  message  to  the 
VAX  Monitor  AP  announcing  the  host  shutdown,  then  shuts 
down  COMM,  its  MPU  and  finally  itself. 
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6.  When  the  VAX  Monitor  AP  has  received  all  "IISS  host 
shutdown"  and  local  "APC  Shutdown"  messages,  or  has 
timed-out  on  any  of  these,  it  shuts  down  the  VAX  COMM 
AP's,  the  COMM  APC,  its  MPU,  sends  a  final  status  message 
to  the  operator,  saves  its  tables,  closes  its  files,  and 
ends  execution. 

7.  Throughout  the  shutd^-./n  IISS  process,  the  Status  Messages 
from  off-host  and  local  APC  shutdowns  are  sent  to  the 
operator . 


SHUTDOWN  HOST  (on  VAX  only) : 

1.  The  Monitor  AP  displays  the  active  host  names  (not  VAX*) 
to  the  operator. 

2.  The  operator  selects  the  desired  host. 

3  .  The  VAX  Monitor  AP  sends  a  "Shutdov/n  Host"  message  to  the 

off-VAX  Monitor  AP. 


*To  shutdown  the  VAX,  a  Shutdown  IISS  command  must  be  issued. 
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4.  Each  non-VAX  Monitor  AP,  on  receiving  the  Shutdown  Command 
sends  Shutdown  APC  messages  to  its  APCs  (except  COMM) . 

When  all  of  the  APCs  "APC  Shutdown"  messages  have  been 
received,  the  non-VAX  Monitor  AP  sends  a  message  to  the 
VAX  Monitor  AP  announcing  the  host  shutdown,  then  shuts 
down  COMM,  its  MPU  and  finally  itself. 

5.  On  receiving  the  "Host  Shutdown"  message,  the  VAX  Monitor 
AP,  shuts  down  the  COMM  AP  for  the  link  to  the  shutdown 
host,  updates  its  status  table  to  indicate  the  status  of 
the  shutdown  host,  sends  a  status  message  to  the  operator, 
and  a  "Host  Status  Update"  message  to  all  of  the  other 
active  IISS  hosts  Monitor  APS. 


CANCEL  IISS  SHUTDOWN; 

1.  The  Monitor  accepts  the  command  and  sends  a  "Cancel 

Shutdown"  message  to  the  UIs,  and  then  updates  its  status 
from  IISS  Shutting  Down  to  IISS  Active.  This  command  only 
applies  during  the  time  that  shutdown  is  pending.  Once 
actual  shutdown  procedures  begins,  it  cannot  be  cancelled. 


ABORT  AP  (VAX  only) ; 

1.  The  operator  enters  AP  name  to  be  shutdown  (the  operator 
finds  active  AP  names  from  the  DISPLAY  ACTIVE  AP  command) . 

2.  If  the  AP  Name  is  legal,  the  MONITOR  AP  sends  the  ABORT  AP 
message  to  the  correct  APC. 

3.  On  receipt  of  the  AP  abort  status  message,  the  MONITOR  AP 
displays  the  status  to  the  operator. 


DISPLAY  ACTIVE  APs  (VAX  only)  : 

1.  On  receipt  of  this  command,  the  Monitor  AP  sends  a  message 
to  the  active  APC  entered  by  the  operator  requesting  a 
list  of  the  active  APs  on  that  APC. 

2.  On  receiving  the  active  list  message  from  the  APC,  the 
list  is  displayed  for  the  operator. 
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DISPLAY  IISS  STATUS  (VAX  only) : 

1.  On  receipt  of  this  command,  the  Monitor  AP  displays  its 
host  and  APC  Status  tables  to  the  operator. 

4 . 1 . 3 . 2 . 3  Deliver  IISS  Status  Messages  to  the  IISS  Operator 

This  function  is  responsible  for  displaying  IISS  status 
and  error  messages  to  the  IISS  operator  on  the  VAX.  These  are 
messages  signalling  events  that  might  require  some  operator 
action.  If  the  Monitor  AP  cannot  write  to  the  IISS  operator's 
console  from  which  it  was  started,  it  will  attempt  to  write  a 
message  to  the  System  Console. 

4. 1.3. 2. 4  Accept  Messages  from  IISS  APC ' s  and  Off-Host  Monitor 
APS 


This  function  is  responsible  for  accepting  messages  from 
IISS  APC ' s  and  off-host  Monitor  APs.  The  messages  that  can  be 
received  during  the  various  IISS  states  are  listed  in  Figure 
4-13  . 
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M*:  AmiCATOimOCRS 


Figure  4-13.  IISS  Messages  Received  by  the  Monitor  AP 
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4. 1.3. 2. 5  Send  IISS  System  Commands  and  Responses 

This  function  is  responsible  for  creating  and  sending  the 
IISS  system  command  messages  from  the  VAX  Monitor  AP  to  the  IISS 
APC's,  APS,  and  off-host  Monitor  APs .  These  messages  are 
created  to  effect  an  IISS  Operator's  command  and  are  listed  in 
Figure  4-14.  See  Appendix  E  for  the  specific  format  of  these 
messages . 


IISS  System 
Comma nd/Response 

Operator  Abort 

Start  Link 

Cancel  Shutdown 

Start  MPU 

List  Request 

Shutdown  Link 

Shutdown  Pending 

Shutdown  APC 

Shutdown  Host 

Rebuild  Tables 

Figure  4 
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Message 


Type 

Destination 

When  Sent 

OA 

APC  of 

Requested  AP 

IISS 

Running 

SL 

COMM  AP 

IISS 

Startup 

IISS  Running 

CS 

UI  APS 

IISS  Running 
with  IISS 
Shutdown 
Pending 

SC 

Monitor ' s 

MPU  on 
requested 

MPU's  Host 

IISS  Startup 
Host  Shutdown 
IISS  Running 

LR 

All  APC's 

IISS  Running 
or  IISS  Shut¬ 
down  Pending 

SD 

COMM  APS 

IISS  Shutdown 
Host  Shutdown 
IISS  Running 

SP 

UI  APS 

IISS  Running 
with  IISS 
Shutdown 
Pending 

DC 

Active  APC 

IISS  Running 
IISS  Shutdown 

SH 

Remote  -  Non-VAX 
Monitor  AP 

IISS  Running 
IISS  Shutdown 

RB 

CDMRP  &  Monitor 
MPU  on  VAX 

IISS  Startup 

,  IISS 

System  Commands  and  Responses 

4-36 


DS  620342000 
30  September  1990 


IISS  System  Message 

Command/Response  Type  Destination  When  Sent 


COMM  &  Monitor  IISS  Startup 
MPU  on  Non-VAX  Hosts 

Display  System  DS  Monitor  AP  IISS  Running 

Status 


Figure  4-14.  IISS  System  Commands  and  Responses 
(Continued) 
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4 . 1 . 3 . 2 . 6  Process  Messages  from  APC's  and  Off-Host  Monitor  APs 

This  function  processes  the  messages  received  by  the 
MONITOR  AP.  The  message  types  received  and  the  processing 
performed  are  in  Figure  4-15. 
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Messaqe 

Message 

Type 

Source 

When  Sent 

Processing 

Link  Active 

LA 

COMM  AP 

IISS  Startup 

Update  Table 

Inform  Operator 

Link  Fail 

LF 

COMM  AP 

IISS  Startup 
IISS  Running 
IISS  Shutdown 

Update  Tables 

Inform  Operator 

Processing 

Error 

31 

IISS  APCs 

IISS  Startup 
IISS  Running 

Inform  Operator 

APC 

Terminated 

CT 

IISS  APCS 

IISS  Startup 
IISS  Running 

IISS  Shutdo'.vn 

Update  Tables 

Logon 

LO 

UI-AP 

IISS 

Running 

Update  Logon 

Table 

Logoff 

OF 

UI-AP 

IISS  Running 
or  IISS 

Shutdov;n 

Update  Logon 

Table 

Table  Status 
Request 

TS 

All  local 
APCs 

IISS  Startup 
or  Running 

Send  Table  Status 
Return  (ST) 

Shutdown 

Host 

SH 

Monitor  AP 

IISS  Running  Shutdown  Host 

or  IISS  Shutdown 

APC  Alive 

LV 

IISS  APCs 

IISS  Startup  Update  Tables 

or  IISS  Shutdown  Inform  Operator 

Resource 

Unavailable 

33 

APCs 

IISS  Startup  Inform  Operator 

and  IISS  Running 

AP  Interface 
Error 

32 

APCs 

IISS  Running 

Inform  Operator 

Tables 

Rebuilt 

RD 

Monitor ' s 
MPU 

IISS  Startup 

Send  "Host  Alive" 
Message  to  APC 

T imeout 
Expired 

TF 

Monitor ' s 
MPU 

Any  IISS 

State 

Take  Timeout  Action 

Unstable 

Tabl  e 

UT 

Any  MPU 
State 

Any  IISS 

Inform  Operator 

Figure  4-15. 

Prcces 
( Host 

sing  of  Messages  Received  by  a 
Status  Messages  in  4. 1.3.8) 

Monitor  AP 
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4 . 1 . 3 . 2 . 7  Send  IISS  Status  Messages 

This  function  is  responsible  for  sending  a  Monitor  AP ' s 
IISS  status  messages  to  remote  Monitor  APs  and  local  APC's.  The 
messages  to  the  remote  Monitor  APs  ensure  that  each  IISS  Monitor 
AP  has  up-to-date  IISS  status  tables.  The  Status  Messages  to 
local  APCs  inform  the  APCs  of  IISS  operating  conditions  and 
ensures  that  the  APC  will  know  when  to  perform  cleanup 
functions.  The  status  messages  sent  by  a  Monitor  AP  for  this 
purpose  are  described  in  Figure  4-16. 
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Message 

Message 

Type 

Update  APC  Tables 

UA 

Update  Host  Tables 

UH 

Host  Available 

HA 

Host  Active 

HU 

Off-Kost  Shutting 

HS 

Destination 

When 

Sent 

Remote 

APs 

Monitor 

IISS 

IISS 

Startup 

Running 

Remote 

APs 

Monitor 

IISS 

IISS 

Startup 

Running 

Remote 

APs 

Monitor 

IISS 

IISS 

Startup 

Running 

Local 

APC '  s 

IISS 

IISS 

Startup 

Running 

Local 

APC '  s 

IISS 

Host 

Running 

Shutdown 

Figure  4-16. 
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4 . 1 . 3 . 2 . 8  Receive  and  Process  Status  Message  from  Other  Hosts 
Monitor  APs 

This  function  is  responsible  for  receiving  and  processing 


status  messages  from  other  Monitor  APs. 
two  identified  messages  of  this  category 

The  processing  for  the 
is  described  below. 

Message 

Message  Type 

Processing 

Host  Available 

HA 

Update 

Tables 

Update  APC  Tables 

UA 

Update 

Tables 

Update  Host  Tables 

UH 

Update 

Tables 

Host  Terminating 

HT 

Update 

Inform 

APCs 

Tables 

Local 
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4 . 2  Detailed  Functional  Requirements 

The  node  tree  shown  in  Figure  4-17  illustrates  all  NTM 
functions  defined  in  the  IDEF\0  Model  (see  Appendix  B  below) . 
Each  function  name  is  followed  by  the  subparagraph  number  where 
a  description  of  the  function  may  be  found. 


OPERATE  NTM 


MANAGE 

MESSAGE 

MANAGE 

PROGESS 

MAINTAIN 

OPERABILITY 

R«citv«  and 

Intarprat  Maiiaga 
(«.2.1) 

•  Intarprat 

Matsaga  Catagory 
(4.2.7) 

.  Handia  Syttam 
Gommandt 
(4.2.12) 

AuthoHsa 

Matsaga 

(«.3.2) 

Complata 

Massaga  Haadar 

(«.2.3) 

Parform  Spacial 

Matsaga  Handling 
(4. 2.  a) 

‘  Initiata 

Application 

Procatt  1 

(4.2.1)  I 

•  Dalivar 

Masaagat  to 

AP 

(4.2.f) 

•  Aceapt  Raquasts 
from  AP 
(4.2.10) 

•  Handia  APC 
Massaga  Ouauat 

(4. 2.13) 

>  Handia  APC 
Tablat 

(4.2.14) 

Log  Matsaga 
(4.  2.  S) 

.  Tarminata  AP 

(4.2.11) 

Routa  and 

Sand  Matsaga 

( 4.  2. ») 

Figure  4-17.  NTM  Functions 
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The  Receive  and  Interpret  Message  function  is  responsible 
for  receiving  and  interpreting  all  messages  from  off-cluster 
that  are  targeted  for  this  cluster  and  all  messages  from 
on-cluster  that  must  be  routed. 

4 . 2 . 1 . 1  Inputs 

Inputs  to  this  function  are  as  follows: 

Description  Source  Range 

Message  on-cluster  APs  All  categories 

on-cluster  MPU 
off-cluster  MPUs 


Message  Category  Table  Internal  tables 


4. 2. 1.2  Processing 

The  processing  of  the  Receive  and  Interpret  Message 
function*  is  described  below: 

a.  Messages  shall  be  received  in  the  APC ' s  input  MPU 
mailboxes  from  on-cluster  APs,  from  the  on-cluster 
MPU,  and  from  other  off-cluster  MPUs.  If  an  error 
is  detected  in  receiving  messages  from  the 
mailboxes.  Receive  and  Interpret  Message  shall 
generate  a  status  message  to  be  sent  to  the  Monitor 
AP, 

b.  A  message  that  has  been  successfully  received  at  an 
MPU  from  another  MPU  must  have  its  destination 
field  interpreted  to  determine  whether  the  message 
has  arrived  at  the  correct  cluster.  The  destination 
field  of  the  message  shall  be  checked  for  the  APC's 
name  or,  if  being  routed  through  the  Communication 
Handler  APC,  for  a  legitimate  off-host  APC 
designation.  Valid  messages  from  other  APCs  shall 
bypass  the  Authorize  and  Complete  Message  Header 
Functions  and  be  sent  directly  to  Log  Message.  An 
invalid  message  from  off-cluster  shall  cause  a 
status  message  to  be  sent  to  the  Monitor  AP. 

c.  Messages  from  on-cluster  APs  shall  indicate  whether 
header  checking  is  to  be  performed  by  the  Manage 
Message  Function.  Header  checking  can  be  bypassed 
if  a  header  that  has  already  'passed'  Manage 
Message  is  reused  by  the  AP  Interface.  These 
messages  are  sent  directly  to  Complete  Message 
Header  to  obtain  a  new  serial  number. 
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d.  A  message,  successfully  received  from  on-cluster 
and  requiring  header  checking,  shall  have  its 
category  field  checked  against  a  table  of  legal 
categories.  Valid  messages  shall  then  be  forwarded 
based  on  the  processing  requirements  of  the  message 
category.  Messages  that  require  authorization  shall 
be  sent  to  Authorize  Message  and  messages  that  do 
not  require  authorization  shall  be  sent  to  Complete 
Message  Header. 

e.  Invalid  messages  shall  be  given  an  error  code  and 
shall  be  sent  to  Log  Message. 

f.  A  message  from  an  on-cluster  AP  with  an  invalid 
category  shall  cause  the  generation  of  a  no-accept 
status  return.  The  no-accept  return  shall  be  sent 
to  Route  and  Send  for  delivery  to  the  source  AP. 

g.  All  messages  from  on-cluster  (from  an  AP  or  from 
the  MPU)  with  an  invalid  category  shall  cause  a 
status  message  to  be  sent  to  the  Monitor  AP.  Since 
the  category  field  is  supplied  by  the  NTM  software, 
a  category  error  implies  an  NTM  software  failure. 

4 . 2 . 1 . 3  Outputs 

Outputs  from  this  function  are  as  follows: 

Description  Destination  Range* 


Received  Messages  Authorize  Message  Category 

* Al 1  of  the  functions  and  their  interfaces  described  in  these 
sections  are  graphically  portrayed  in  the  IDEF\0  Model  contained 
in  Appendix  B  below. 
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Description 


Received  Messages 
(Continued) 


Send  Status  on 
Message  and  Status 
Messages  to  the 
Monitor  AP 


Destination 


function 


Complete  Message 
Header  function 


Log  Message  function 


Route  &  Send  Message 
function 


Range 


A,B,E,H  and  J 
messages 

All  Category  C, 
D,  F,  and  G 
messages  from 
on-cluster  to 
be  routed. 

All  accepted 
messages  from 
off-cluster 

-and 

All  rejected 
messages 

All  status 
messages  for 
the  Monitor  AP 
generated  by 
Receive  and 
Interpret 
function 


-and- 


Send  status 
returns  to 
on-cluster  APs. 


4.2.2  Authorize  Message  Function 

The  Authorize  Message  function  is  responsible  for 
establishing  the  authority  of  an  application  process  to  issue 
the  specified  message  type  to  the  specified  destination  AP. 


4 . 2 . 2 . 1  Inputs 

Inputs  to  this  function  are  as  follows. 
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Description 


Source 


Range 


Messages  Possibly  Receive  &  Interpret 

Requiring  Authorization  Message  Function 


Category  A,B,E, 
and  H  Msgs  (Mgs 
Requiring 
Possible 
Authorizatic 


Authority  Check  Internal  Table  N/A 

Table 

Authority  Table  Internal  Table  N/A 

4 . 2 . 2 . 2  Processing 

The  processing  is  described  below: 

a.  A  message  arriving  at  Authorize  Message  is  first 
checked  for  an  authorization  requirement.  The 
message  destination  is  checked  against  the 
Authority  Check  Table  to  determine  if  the 
destination  AP  has  any  authorization  requirements. 
If  authorization  is  not  indicated,  the  message  is 
sent  to  Complete  Message  Header. 

b.  A  message  that  requires  authorization  shall  have 
its  message  type,  source  AP  and  destination  AP 
combination  checked  against  the  Authority  Table 
that  contains  a  list  of  message  types  that  are 
valid  between  the  specified  source  and  destination 
APs.  A  valid  message  is  sent  to  Complete  Message 
Header . 


c.  Invalid  messages  shall  be  given  a  status  indicating 
an  authorization  error  and  be  sent  to  Log  Message. 

d.  Authorize  shall  also  generate  a  status  return  to  be 
returned  to  the  originator  of  the  invalid  message. 
This  return  shall  be  sent  to  Route  and  Send. 

e.  Table  access  errors  shall  cause  a  status  message  to 
be  sent  to  the  Monitor  AP. 

f.  If  the  destination  AP  is  not  found  in  the  tables, 
an  invalid  destination  message  will  be  sent  to  the 
source  of  the  message. 
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4 . 2 . 2 . 3  Outputs 

Outputs  from  this  function  are  as  follows: 


Description 

Destination 

Range 

Authorized  Messages 

Complete  Message 

Header  function 

Authorized 
Category  A, 

B,  E,  H,  and  J 
messages 

Messages  That  Did 

Not  Require 
Authorization 

Complete  Message 

Header  function 

Category  A,  B, 

E,  H,  and  J 
messages  with 
no  authori¬ 
zation  require¬ 
ment 

Send  Status  on 

Message  and  Status 
Messages  to  the 

Monitor  AP 

Route  &  Send  Message 
function 

"Authorization 
Denied"  status 
return 

Table  error  to 
Monitor  AP. 
Invalid 
Destination 
error  to  source 
AP 

Messages  rejected 
by  MM 

Log  Message  Function 

Rejected 

messages 

4.2.3  Complete  Message  Header  Function 

The  Complete  Message  Header  function  is  responsible  for 
supplying  message  header  information. 

4 . 2 . 3 . 1  Inputs 

Inputs  from  this  function  are  as  follows: 
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Description 

Source 

Range 

Authorized  Category 

A,  B,  E,  H,  and  J 
Messages 

Authorize  Message 
Function 

Authorized 

Messages 

Category  A,  B,  E,  H,  J 
Messages  with  No 
Authorization 
Requirement 

Authorize  Message 

Category  A,  B 
E,  H,  and  J 
messages  with 
no  authority 
requirement 

Category  A-J 

Messages 

Receive  and  Interpret 
Message 

Category  A,  B 
E,  H,  J  mes¬ 
sages  that  do 
not  require 
Header 

verification 

Category  C,  D 
F,  G  messages 

Message  Category 

Table 

Internal  Table 

N/A 

AP  Information 

Table 

Internal  Table 

N/A 

AP  Characteristics 

Table 

Internal  Table 

N/A 

Message-Serial -Number 

Internal  Data  Item 

1-9 , 999 , 999 

4 . 2 . 3 . 2  Processing 

a.  For  messages  that  require  header  verification 
(header  processing  flag  =  '0'),  Complete  Message 
Fleader  checks  the  required  header  fields  supplied 
by  the  AP  Interface  from  APC  tables  and  data  from 
the  AP's  Service  Call.  If  any  required  field  is 
blank,  the  message  is  invalid.  (Send  status  will 
indicate  'Header  Processing  Error').  Since  this 
error  may  indicate  an  NTM  failure,  a  status  message 
will  also  be  sent  to  the  Monitor  AP  indicating  an 
'MPU  Processing  Error.' 

b.  For  messages  requiring  header  verification,  the 
Source  MPU  next  supplies  all  of  the  remaining  MPU 
header  values  except  a  message  serial  number  to  the 
message  header.  (See  Section  4. 1.3.1  for  a 
description  of  the  header  values.)  If  the  MPU 
cannot  find  any  required  field  entry  for  the  AP  in 
it^  tables,  the  message  is  invalid.  (Send  status 
indicates  'Table  Entry  Not  Found  Error'). 


4-4  9 


DS  620342000 
30  September  1990 


The  MPU,  on  messages  requiring  header  verification, 
may  supply  default  values  for  the  following  header 
fields:  Binary/Native  Flag,  Integrity  Check  Flag, 
Test  Flag,  Delay  Trigger  Flag,  Delay  Trigger 
Conditions,  and  Logical  Channel  ID. 

A  message  serial  number  is  supplied  to  the  header 
of  all  messages  processed  by  Complete  Message 
Header.  This  serial  number,  with  the  APC  name  of 
this  cluster,  forms  a  unique  IISS  message 
identifier. 

Invalid  messages  shall  be  given  a  status  indicating 
the  type  of  error  and  are  sent  to  Log  Message. 

Valid  messages  shall  be  given  a  status  code 
indicating  their  validity  and  are  sent  to  Log 
Message . 

MPU  file  and  table  access  errors  during  Complete 
Message  Header  shall  cause  a  status  message  to  be 
sent  to  the  Monitor  AP. 

Complete  Message  Header  shall  also  generate  a 
status  return  to  be  returned  to  the  originator  of 
the  invalid  message. 

Complete  Message  Header  shall  check  the  message 
category  of  all  valid  messages  to  determine  if  any 
special  message  processing  is  required.  If  neither, 
an  "accepted"  status  message  shall  be  generated  to 
be  returned  to  the  originator. 

All  messages,  except  status  returns,  status 
messages  to  the  monitor  AP,  and  messages  requiring 
special  message  handling  shall  be  sent  to  Log 
Message . 
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j .  Status  returns  and  status  messages  to  the  Monitor 
AP  shall  be  sent  to  Route  and  Send. 

k.  Messages  requiring  special  message  handling 
(Category  A,  B,  H,  and  J  messages)  are  sent  to 
Special  Message  Handling. 

4 . 2 . 3 . 3  Outputs 

Outputs  from  this  function  are  as  follov/s: 

Description  Destination  Range 


Accepted  msgs  from 
on-cluster  with 
no  special  handling 
requirements 


Log  Message  Function 


Accepted 
Category 
C-G  messages 


Messages  from  on- 
cluster  with  a  special 
requirement 

Messages  rejected 
by  MM 


Send  Status  on 
Message 


Perform  Special  Message  Category  A, 
Handling  function  B,  H,  handling 

and  J  messages 

Log  Message  Function  Messages 

rejected 
by  Complete 
Message  Header 


Route  and  Send  Message  "Header  Error" 
Function  Status  Return 


"Message 
Accepted" 
Status  Return 


Status  Message  to 
Monitor  AP 


Route  and  Send  Message  "Table  Access 
Function  Error"  msg  to 

MONITOR  AP 


"MPU  Processing 
Error"  message 
to  the  Monitor 
AP 
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4.2.4  Perform  Special  Message  Handling  Function 

The  Perform  Special  Message  Handling  function  is 
responsible  for  updating  the  MPU ' s  tables  for  guaranteed 
delivery,  message  pairing,  or  the  sending  APs  Child  Table  for 
messages  that  require  entries  in  any  of  these  special  message 
tables . 


4 . 2 . 4 . 1  Inputs 

Inputs  to  this  function  are  as  follows: 


Description 

Source 

Range 

Category  A  Messages 
from  on-cluster 

Complete 

Message 

Header 

Guaranteed 

Delivery 

messages 

Category  B  and  D 
Messages  from 
on-cluster 

Complete 

Message 

Header 

Message 
requiring  a 
response 

Category  H  and  J 
Messages  from 
on-cluster 

Complete 

Message 

Header 

Specific 

Initiation 

messages 

Category  E  Messages 
having  no  Destination 
Instance 

Complete 

Message 

Header 

Message  that 
may  require  the 
initiation 
of  an  AP 

Message  Pairing  Table 

Internal 

table 

N/A 

Guaranteed  Delivery 
Table 

Internal 

table 

N/A 

Child  Table 

4. 2. 4. 2  Processing 

Internal 

Table 

N/A 

a.  If  the  message  received  is  a  Category  A  message,  an 

entry  is  made  to  the  Guaranteed  Delivery  Table. 


b.  If  the  message  received  is  a  Category  B,  D  or  J 
message,  an  entry,  with  a  timeout  value,  is  made  to 
the  Message  Pairing  Table.  If  the  table  entry  is 
successfully  made,  a  'message  accepted'  status  is 
returned  to  the  sender. 

c.  If  the  message  received  is  a  Category  H  or  J  message, 
an  entry  that  indicates  a  status  of  'initiation 
message  sent'  is  made  to  the  Child  Status  Table  for 
the  sending  AP.  If  the  table  entry  is  successfully 
made,  a  'message  accepted'  status  is  returned  to  the 
sender . 
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d.  If  there  is  no  destination  instance  and  the  category 
indicates  that  an  AP  may  be  initiated  (i.e.  category 
B  or  E)  a  child  table  entry  will  be  created  with  a 
status  of  "reserved". 

e.  If  the  attempt  to  make  an  entry  into  any  of  the 
tables  is  unsuccessful,  a  'Resource  Unavailable'  send 
status  is  returned  to  the  sender  via  the  Route  and 
Send  message  function.  In  addition,  a  'Table  Access 
Error'  status  message  is  sent  to  the  Monitor  AP  to 
inform  the  IISS  operator  of  the  event. 

f.  Messages  thac  were  not  processed  because  of  table 
access  failures  are  sent  to  Log  Message  with  a 
logging  code  that  indicates  'Resource  Unavailable'. 

4. 2, 4. 3  Outputs 

Outputs  from  this  function  are  as  follows: 

Description  Destination  Range 


Processed  Category  A,  Log  Message  function 
B,  D,  and  H  messages 
from  on-cluster 


Unaccepted  Category  A,  Log  Message  function 
B,  D,  and  H  messages 
from  off-cluster 


All  Category  A, 

B,  D,  H,  and  J 
messages  that 
have  been 
successfully 
processed  in 
Special  Message 
Handling. 

All  messages  B, 

(Category 

A,  B,  D,  H  and  J) 
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Description  Destination 


Unaccepted  Category 
A,  B,  D  and  H  Messages 
from  off-cluster 
{ Continued) 


Send  Status 


Route  &  Send  Message 
function 


Status  Message  to  Route  &  Send  Message 

Monitor  AP  function 


Range 


that  could  not  be 
processed 
by  Special 
Message  Handling 
due  to  a 
Table  Access 
Error. 

"Accepted 

Message" 

status  returns  on 
successfully 
processed 
Category  B,  D,  H, 
and  J  messages. 

"Resource 
Unavailable" 
status  returns  on 
all  Category  A, 

B,  H,  and  J 
messages  that 
were  not 

processed  because 
of  a  Table  Access 
error. 

"Table  Access 
Error"  status 
message  to  the 
Monitor  AP  on 
messages  not 
successfully 
processed  by  the 
Special  Message 
Handling 
function . 


4.2.5  Log  Message  Function 

The  Log  Message  function  is  responsible  for  logging  messages. 
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Message  Rejected 
by  MM 

Receive  &  Interpret 
Message  function 

Rejected  messages 
from  off-cluster 
due  to  routing 
failures 

Rejected  messages 
from  on-cluster 
due  to  unrecog¬ 
nized  category 

Authorize  Message 
function 

Rejected  messages 
from  on-cluster 
due  to  an 
authorization 
failure 

Complete  Message 

Header  function 

Rejected  messages 
from  on-cluster 
due  to  header 
errors 

Message  Rejected 
by  MM  (Continued) 

Perform  Special 

Message  Handling 

Rejected  messages 
from  on-cluster 
due  to  special 
message  handling 
failure 

Accepted  Messages 
from  On-cluster 

Complete  Message 

Header  function 

Accepted  messages 
with  completed 
header  (all 
categories) 

Accepted  Messages 
from  Off-Cluster 

Receive  &  Interpret 
Message  function 

Accepted  messages 
off-cluster  (all 
categories ) 

Log  format 

Internal  Tables 

N/A 
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4. 2. 5. 2  Processinc 


The  processing  is  described  below. 


a.  Log  Message  shall  add  an  entry  to  the 

message  log  for  each  message  received.  The 
log  entry  will  include:  the  message,  an 
error  code  for  rejected  messages,  and  the 
host's  clock-time  stamp  at  the  time  of  the 
log . 

b.  Entries  into  a  separate  error  log  could  be 

made  for  all  error  conditions  encountered 
in  the  message  processing.  The  format  of 
this  error  log  has  not  yet  been  determined 
but  should  include  an  error  code,  the 
error  source,  ID  and  the  host's  clock-time 
stamp.  For  the  initial  Test  Bed,  this  will 
not  be  a  separate  log. 

c.  Log  Message  shall  check  the  message 

category  to  determine  if  guaranteed 
delivery  is  reguired.  If  so,  a  "logged" 
status  message  shall  be  generated  to  be 
returned  to  the  originator. 

d.  If  an  error  occurs  in  loggi’.g,  Log  Message 

shall  generate  a  status  message  to  be  sent 
to  the  Monitor  AP  via  Route  and  Send 
Message.  Error  conditions  may  include  file 
access  errors,  file  space  errors  and  file 
write  errors. 


e . 


All  accepted  messages  shall  be  sent  to 
Route  and  Send  Message. 


4 . 2 . 5 . 3  Outputs 

Outputs  from  this  function  are  as  follows; 


Description 


Destination 


Range 


Logged  Messages  Route  &  Send  Message  All  accepted  and 

function  logged  messages 

from  off-cluster 
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Description 


Send  Status 


Status  Messages  to 
Monitor  AP 


Message  Log 


Destination 


Route  &  Send  Message 
function 


Route  &  Send 
Message  function 


Internal  file 


Range 


All  accepted  and 
logged  messages 
from  on-cluster 

Message  accept 
status 

on  Guaranteed 

Delivery 

messages 

Status  Message 
to  the  Monitor  AP 
"Error  condition 
on  log" 

N/A 


4.2.6  Route  and  Send  Message  Function 

The  Route  and  Send  Message  function  is  responsible  for 
forv;arding  messages  to  their  next  destination. 

4 . 2 . 6 . 1  Inputs 

Inputs  to  this  function  are  as  follows: 

Description  Source  Range 


Logged  Messages 


Send  Status  and 
Status  Messages 


Log  Message  function 


Receive  &  Interpret 
Message  function 


Authorize  Message 
function 


All  accepted 
and  logged 
messages 
from  on-cluster 
and  off-cluster 

All  status  re¬ 
turns  to  the 
Source  AP  and 
status  messages 
to  the 
monitor  AP 
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Range 


Complete  Message  Header 
function 

Perform  Special  Message 
Handling  function 

Log  Message  function 

Host  &  APC  Status  Internal  Tables  N/A 

Tables 


4. 2. 6. 2  Processing 

The  processing  is  described  below. 

a.  Route  and  Send  Message  shall  check  the  destination 
field  of  a  message  and  access  internal  table 
information  to  determine  routing. 

b.  If  the  destination  is  for  an  on-cluster 
application,  the  message  shall  be  sent  to  the 
Manage  Process  function  of  the  NTM. 

c.  If  the  message  is  a  system  command  (Category  C  and 
D  messages)  for  the  on-cluster  NTM,  the  message 
shall  be  sent  to  the  Maintain  Cluster  Operability 
function  (Handle  System  Commands,  4.2.12). 

d.  If  the  destination  is  off-cluster.  Route  and  Send 
Message  shall  check  the  host  designation. 

e.  If  the  destination  is  off-cluster,  the  status  of 
the  destination  APC  will  be  checked  in  the  APC 
Status  Table.  If  the  destination  APC  is 
unavailable,  a  status  message  is  sent  to  the 
monitor  AP  and  the  source  to  inform  them  that  the 
destination  resources  are  unavailable.  If  the 
message  is  a  guaranteed  delivery,  it  will  be 
queued.  Otherwise,  the  message  is  lost. 

f.  If  the  destination  cluster  is  on-host,  the  message 
shall  be  sent  to  the  correct  off-cluster  mailbox 
(Receive  and  Interpret  Message  function  of  MM) . 

g.  If  the  destination  is  off-host,  the  message  shall 
be  sent  to  the  correct  on-host  COMM  APC  mailbox 
(Receive  and  Interpret  Message  function)  . 

h.  If  a  recoverable  error  (e.g.,  mailbox  full)  is 
detected  on  a  send.  Route  and  Send  Message  shall 
queue  the  message  for  later  delivery. 
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i.  If  an  unrecoverable  error  (e.g.,  unrecoverable 
status  returned) ,  Route  and  Send  Message  shall 
generate  a  status  message  and  attempt  to  send  it  to 
the  Monitor  AP. 

j .  If  an  unrecoverable  error  occurs  on  sending  a 
message  to  the  Monitor's  APC,  ERRPRO  will  be 
called . 


4 . 2 . 6 . 3  Outputs 

Outputs  from  the  function  are  as  follows: 


Description 

Destination 

Range 

Messages  to  Off- 
cluster 

Manage  Message:  via 
Off-Cluster  MPU  mail 
box  Receive  &  Inter¬ 
pret  function) 

All  messages 
with 

off-cluster 

destinations 

On-cluster  AP 

Messages,  Send  Status 

Manage  Process  (Inter¬ 
pret  Message  Category 
function) 

All  messages 
with  on- 
cluster  AP 
destinations 

Manage  Process 

All  status 
returns  for 
on-cluster 
messages 

Status  Returns 

Accept  Requests  from 

AP  of  the  Manage  Pro¬ 
cess  function 

All  on-cluster 
status  returns 
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Description 


Destination 


Range 


Status  Messages 
Monitor 


Manage  Message  function  All  status  to 
of  the  Monitor  AP's  messages 

MPU  to  monitor 

AP 


4.2.7  Interpret  Message  Category  Function 

The  Interpret  Message  Category  function  is  responsible  for 
receiving  a  message  from  the  Route  and  Send  Message  function  and 
forwarding  it  to  the  appropriate  Manage  Process  subfunction. 

4 . 2 . 7 . 1  Inputs 

Inputs  to  this  function  are  as  follows: 

Description  Source  Range 


On-cluster  AP  Message,  Route  &  Send  Message 
Send  Status  function  of  Manage 

Message 


Message  Category  Table  Internal  tables 


Shutdown  AP 
request 
Abnormally 
terminate 
AP  request 
Data  messages 
for  APs  Status 
response 

N/A 


4 . 2 . 7 . 2  Processing 

The  processing  is  described  belov;. 

a.  This  function  shall  accept  as  input  an  on-cluster 
AP  message  or  message  for  the  NTM  from  Manage 
Message . 

b.  This  function  shall  interpret  the  message  category 
based  on  the  message  category  table  and  route  the 
message  to  the  appropriate  function  as  follows: 

o  A  message  that  explicitly  requires 

initiation  of  an  application  process 
(Category  H  or  J)  shall  be  routed  to 
Initiate  Application. 

o  A  shutdown  AP  request  or  abnormally 

terminate  AP  request  message  shall  be  routed 
to  Terminate  Application  Process. 
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o  A  Data  Message  shall  be  routed  to  deliver 

message  to  Application  Process. 

4 . 2 . 7 . 3  Outputs 

Outputs  from  this  function  are  as  follows: 

Description  Destination 


Interpreted  Message  Initiate  Application 

Process  function 

Abnormally  Terminate 
or  Shutdown 
AP  function 


Deliver  message  to 
AP  function 


4.2.8  Initiate  Application  Process  Function 

The  Initiate  Application  Process  function  is  responsible 
for  initiating  and  establishing  a  connection  with  an  application 
process . 


4 . 2 . 3 . 1  Inputs 

Inputs  to  this  function  are  as  follov/s: 
Description  Source  Range 


Range 


Category  A,  B,  E, 
H  and  J  messages 

Shutdown  AP 
request 
Abnormally 
Terminate 
AP  request 

Data  Message 


Category  A,  B,  E, 


Interpret  Message 


Message 
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Description 

Source 

Range 

H,  and  J 

Messages 

function 

identified 
as  an  initia¬ 
tion  message 

AP  Initiation  Service 
Request 

Initiated  AP 

N/A 

Startup  Status 

Messages  from  the 
Initiated  AP's 

Interface 

AP  Interface 

"I'm  Alive" 

status 

message 

"Startup 

failed" 

status  message 

Initiate  &  Connect 

AP  Status  Response 

Host  Operating  System 
or  IPC  Primitive 

Status  return 
indica¬ 
ting  status  of 
AP  initiate  and 
connect 

AP  Operating  Infor¬ 
mation  Table 

Internal  Tables 

N/A 

AP  Characteristics 

Table 

Internal  Tables 

N/A 

AP  Status  Table 

Internal  Tables 

N/A 

I'm  Al ive  Table 

Internal  Tables 

N/A 

4. 2. 8. 2  Processing 

a.  On  an  initiation  request  message,  the  AP  Operating 

Information  Table  of  the  APC  is  referenced  to 
determine  the  number  of  instances  of  the  AP  that 
are  currently  active  and  to  determine  the  number  of 
requests  that  are  queued  for  the  AP. 


a.l  If  there  are  no  instances  of  the  AP  currently 

active,  the  MPU  shall  initiate  the  AP. 


a. 2  If  there  are  one  or  more  instances  of  the  AP 

currently  active,  the  MPU  shall  check  the  AP 
Characteristic  Record  to  determine  if  the 
requested  AP  is  a  queue  server  and  determine 
the  maximum  number  of  running  instances  of 
this  AP  allov/ed. 
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a. 2.1  If  the  AP  is  a  queue  server 

(number  of  parents  per  instance  is 
greater  than  one) ,  the  MPU  shall 
check  the  AP  Characteristic  Table 
to  determine  the  maximum  number  of 
connections  allowed  for  this  AP 
against  the  number  of  current 
connections  indicated  in  the  AP 
Status  Table. 

a. 2. 1.1  If  the  number  of  current 
connections  is  less  than 
the  maximum  number 
allowed,  the  message  is 
sent  to  the  AP's  mailbox 
and  the  number  of  AP 
connections  is  updated  in 
the  AP  Status  table. 

a.  2. 1.2  If  the  number  of  current 
connections  is  equal  to 
the  maximum  allowed,  the 
AP  Characteristic  Record 
is  checked  and  the 
conditions  are  handled  as 
in  a . 2 . 2  and  a . 2 . 3 . 

a. 2. 2  If  the  number  of  active  instances  is  less  than  the 
number  allowed,  the  MPU  shall  initiate  the  AP. 

a. 2. 3  If  the  number  of  active  instances  is  equal  to  the 
maximum  number  allowed,  the  AP's  characteristic 
record  is  checked  to  determine  the  allowed  number 
of  queued  requests  for  the  AP. 

a. 2. 3.1  If  the  maximum  queue  size 
is  greater  than  the 
current  queue  size,  the 
message  is  queued  for  the 
AP  and  the  AP  Operating 
Information  Table  is 
updated  to  indicate  an 
addition  to  the  queue  for 
the  AP. 

a. 2. 3.2  If  the  maximum  queue  size 
equals  the  current  size, 
a  "Resource  Unavailable" 
status  message  is 
formatted  and  sent  to 
Manage  Message  for 
routing  to  the  MPU  where 
the  initiation  request 
w^'^s  made. 


4-63 


DS  620342000 
30  September  1990 


b.  If  initiation  of  an  AP  is  indicated, 

Initiate  AP  requests  the  host  Operating 
System  to  initiate  the  AP.  The  MPU 
supplies  a  process  name  for  the  AP  in 
the  initiation  request. 

b.l  If  a  successful  initiation  is  indicated  by 

the  Operating  System  Response,  the  following 
procedure  is  followed. 

b.l.l  The  AP  Status  Table  is  updated  with  a 
new  record  for  this  new  instance  of 
the  AP.  The  status  is  indicated  as 
initiated. 

b.l. 2  An  entry  into  the  I'm  Alive  Table  is 
made  to  indicate  that  the  MPU  is 
awaiting  a  message  from  the  initiated 
AP  to  indicate  that  it  successfully 
started  execution. 

b.l. 3  If  the  data  portion  of  the  initiation 
message  is  non-blank  (data-length  = 

0) ,  the  data  for  the  AP  shall  be 
queued  to  be  delivered  when  the  AP's 
"I'm  Alive"  message  is  received. 

b.1.4  The  AP  Operating  Information  Table  is 
updated  to  indicate  the  current 
number  of  instances  active. 

b.2  If  a  non-successful  initiation  is  indicated 
in  the  Operating  System  Response,  the  MPU 
will  send  an  "Initiation  Failure"  message  to 
the  MPU  where  the  initiation  request 
originated.  A  status  message  will  also  be 
sent  to  the  Monitor  AP  to  indicate  the 
initiation  failure  event. 

b.3  On  receipt  of  an  "I'm  Alive"  message  from 
the  initiated  AP,  the  MPU  changes  the  AP's 
process  status  state  entry  from  "initiated" 
to  "running",  signals  the  Deliver  Message 
function  to  send  the  IISS  System  State 
Status,  and  any  AP  data  that  was  carried  in 
the  initiation  message  to  the  initiated  AP. 

b.4  If  instead  of  an  "I'm  alive"  message,  the 

MPU  receives  an  "Initiation  failure"  message 
from  the  AP  Interface,  it  updates  the  APC 
tables  to  indicate  the  failure  event  and 
sends  the  "Initiation  failure"  messages 
described  above  in  b.2. 
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c.  when  an  IISS  AP  is  initiated,  it  must  call  one  of 

the  NTM ' s  Initiation  Service  Routines.  New  APs  will 
call  "INITAL"  [8],  the  NTM  Service  module  described 
below. 

c.l  "INITAL"  provides  the  mailbox  connections  of 
the  AP  to  the  NTM  that  will  enable  the  AP  to 
send  and  receive  messages  from  other  IISS 
APs. 

c.1.1  "INITAL"  creates  the  AP ' s  low 
priority  and  ACK  mailboxes. 

c.l. 2  "INITAL"  uses  the  IPC  Primitives  [9], 
that  in  turn  use  operating  system 
calls  to  create  the  required  AP  input 
mailboxes.  The  AP ' s  MPU-given  process 
name  is  used  to  form  the  AP's  mailbox 
names;  the  process  name  is 
concatenated  with  A  for  an  AP's  ACK 
mailbox,  and  with  C  for  the  AP's 
normal-  priority  mailbox.  "INITAL" 
determines  the  AP's  process  name  by 
an  operating  system  call  on  the  VAX 
and  from  the  initiation  parameter 
list  on  the  IBM. 

C.2  If  the  mailbox  connection  requests  are 

successful,  "INITAL’’  estab]  ishes  an  IISS 
exception  handler  for  the  AP.  (This 
Exception  Handler  will  trap  all  Operating 
Systems  and  Machine  Exceptions  for  the  AP, 
formulate  a  status  message  for  the  MPU  of 
the  AP's  parent  (spawner) ,  and  then 
terminate  the  AP. ) 

C.3  If  the  initiation  procedure,  INITAL,  is 
still  successful  at  this  point,  an  "I'm 
Alive"  message  that  contains  the  AP's 
process  name  is  sent  to  one  of  its  MPU's 
mailboxes . 

c.3.1  If  a  non-recovei^able  failure  status 
is  returned  on  this  IPC  SEND  to  the 
MPU's  mailbox,  "INITAL"  calls 
ERRPRO,  and  returns  an 
INITAL-NOT-SUCCESSFUL  code  to  the 
calling  AP. 

c.3.2  If  a  "mailbox-full"  status  is 

returned  on  this  IPC  SEND,  a  timer  is 
set  by  "INITAL"  and  on  the  timers 
completion,  the  SEND  is  repeated. 

This  step  is  repeated  until  the  call 
is  successful  or  until  the  number  of 
times  tried  surpasses  the  IISS  set 
limit. 
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C.4  If  the  "I'm  Alive"  message  is  successfully 
sent,  "INITAL"  reads  (with  a  wait)  the  AP's 
input  mailbox  for  a  message  from  the  MPU 
that  contains  the  IISS  System  State  (IISS 
Startup,  IISS  Recovery,  or  IISS  Normal 
Operations)  for  special  AP  startup  state 
information,  such  as,  first  run  since  IISS 
start.  The  system  state  message  also  carries 
information  about  the  AP,  such  as  the  number 
of  mailboxes  it  supports,  and  the  original 
source  AP.  A  timer  is  also  set  when  the 
read  is  issued. 

c.4.1  If  a  mailbox  event  occurs  before  the 
timer  and  the  received  message 
contains  the  IISS  system-state 
information,  "INITAL"  checks  the 
number  of  mailboxes  the  AP  will 
support  (None,  if  the  AP  receives  no 
messages;  one,  if  the  AP  can  receive 
no  high-priority  shutdown  messages 
from  the  NTM,  and  two,  if  the  AP  can 
receive  high-priority  messages.)  If 
the  AP  supports  no  mailboxes,  the  low 
priority  and  ACK  are  deleted.  If  the 
AP  supports  two  mailboxes,  "INITAL" 
will  create  the  AP's  high  priority 
mailbox.  Upon  successful  handling  of 
the  mailboxes  returns  to  the  AP  with 
the  SYSTEM-STATE  and  a  successful 
STARTUP-STATUS . 

c.4. 2  If  the  message  received  is  not  the 
system-state  message,  "INITAL" 
returns  to  the  AP  with  an 
INITAL-NOT-SUCCESSFUL  status. 

c.4. 3  If  a  timer  event  occurs  before  a 

mailbox  event,  "INITAL"  returns  to 
the  AP  with  an  INITIAL-NOT-SUCCESSFUL 
status . 

d.  Figure  4-18  depicts  the  roles  of  the  AP,  the  AP 

Interface  and  the  MPU  in  the  successful  initiation 
of  an  AP. 
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AP 


AP  Interface 


MPU 


3.  Executing  AP  calls 
"INITAL"  to  ini¬ 
tiate  its  connection 
to  the  NTM 


1.  OS  call  to 
initiate  AP 

2.  Successful 
return  from 
OS  call  -  A 
C  table  up¬ 
dates  to 
indicate  the 
initiation 
of  AP 


4.  "INITAL"  creates  the 
AP's  Low  Priority  and 
ACK  mailboxes 

5.  "INITAL"  establishes 
the  IISS  exception 
handler  for  the  AP 

6.  "INITAL"  sends  an 
"I'm  Alive"  message 
to  the  MPU 

7.  The  MPU  re¬ 
ceives  the 
"I'm  Alive" 
message  and 
updates  its 
AP  state  ta¬ 
bles  accor¬ 
dingly. 

8.  The  MPU 
sends  the 
AP  the  IISS 
System 
State 

information 
and  any 
AP  initiation 
data  that  was 
carried  in 
the  initia¬ 
tion  message 


Figure  4-18.  AP  Initiation 
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10  . 


9.  INITAL  receives  the 
system  state  message 
from  the  MPU  establishes 
the  correct  number  of 
mailboxes  and  return 
to  the  AP 

The  AP  begins  its 
operating  code 
and  issues  a  CALL 
"PCV"  if  it  expects 
initiation  data 


Figure  4-18.  AP  Initiation  (Continued) 
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4. 2. 8. 3  Outputs 
Description 


Initiate  AP  Request 

Create  AP  Mailbox 
Request 

Initiation  Status 
Messages  from  AP 
Interface 


Initiation  Status  Msg 
Arrival  Notification 

Initiation  Status 
Messages  to  the 
MONITOR  AP  and  source 
MPU  from  the  AP's  MPU 


Destination 

Host  Operating  System 

Host  Operating  System 
(via  IPC  Primitive) 

Manage  Message  Function 
(MPU's  input  mailbox) 

Deliver  Message 
to  AP 

Manage  Message  Function 


AP  Message  Queue  Update  Internal  Table 


APC  "I'm  Alive"  Table  Internal  Table 
Entry 
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Range 


N/A 

N/A 


"I'm  Alive" 
"Initiation 
Failed" 
msgs 

"I'm  Al ive" 


"Initiation 
Fa i lure" 
messages 


Initiation  Data 
for  AP 

"I'm  Al ive 
Waiting  Entry 

"I'm  Al ive" 
Arrived  - 
Cancels  Entry 
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4.2.9  Deliver  Messages  to  Application  Process 

The  Deliver  message  to  Application  Process  function  is 
responsible  for  delivering  messages  to  the  AP.  This  function 
includes  the  MPU ' s  writing  of  the  message  to  the  AP ' s  mailbox, 
and  the  AP  Interface's  reading  of  the  message  from  the  AP ' s 
mailbox,  its  stripping  of  the  NTM  message  header,  and  its 
delivery  of  the  message  data  to  the  destination  AP. 


4 . 2 . 9 . 1  Inputs 

Inputs  to  the  function  are  as  follows. 
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Description 


Source 


Range 


Messages  for 
On-Cluster  APs 


Operating  System 
Response  (IPC  Response) 


NTM  Service: 
Call  "RCV" 
Arguments 


Interpret  Message 
Category 


Host  Operating 
System 


Source  AP  Requesting 
Message 


All  messages 
for  on-cluster 
APs 

Responses  to 
"SNDMSG" , 
"RCVMSG" , 
"SETTIM" , 
"WAIT",  IPC 
Primitives 

N/A 


4 . 2 . 9 . 2  Processing 

a.  On  receipt  of  a  message  for  an  on-cluster  AP  that 
has  already  been  initiated  by  the  message  source, 
the  Deliver  Message  to  AP  function  sends  the 
message  to  the  correct  mailbox  of  the  AP. 

a.l  If  an  unrecoverable  error  status  is 

returned  on  the  ’SNDMSG'  call,  a  status 
message  is  sent  to  the  monitor  AP  and  to 
the  MPU  of  the  message  source  signifying 
the  'MAILBOX  WRITE  ERROR.' 

a. 2  If  the  AP's  mailbox  is  full,  the  message  is 

added  to  rhe  on-cluster  AP's  message  queue. 

b.  On  notification  by  the  Initiate  Message  function  an 
of  an  "I'm  Alive"  message  from  an  initiated 
on-cluster  AP,  Deliver  Message  formulates  and  sends 
to  the  AP,  a  System-State  Message  that  contains 
IISS  State  Information,  and,  if  required,  a  message 
containing  the  AP's  initiation  data.  On  a  send 
failure,  the  actions  of  a.l  or  a. 2  are  taken. 


c.  In  response  to  an  AP's  RCV  Service  Request,  the  AP 

Interface  first  searches  the  AP's  message  buffer 
for  the  requested  messages.  If  it  is  found  then 
Step  c.l  is  performed.  If  it  is  not  found  the  AP 
Interface  reads  the  AP's  mailbox(es) .  If  a  wait  is 
implied,  the  AP  Interface  v;aits  for  a  message  and 
v;hen  one  is  received,  checks  whether  the  message 
header  satisfies  the  AP's  request.  If  no  wait  is 
signaled,  a  "GETMSG"  IPC  call  is  made  after  the 
"RCVMSG"  call. 
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c.l  If  a  message  is  in  the  buffer  or  in  the 

mailbox  and  is  of  the  type  requested,  the  AP 
Interface  removes  the  NTM  header  and  delivers 
the  data  portion  and  required  arguments  to 
the  AP. 

C.2.  If  the  message  is  not  of  the  type  requested, 
the  AP  Interface  buffers  the  message  for  a 
later  AP  request  and  either  returns  to  the  AP 
with  a  non-message  status  if  the  request 
signalled  "no-wait,"  or  rereads  the  AP's 
mailbox(es)  for  another  message  if  the  AP's 
request  implied  a  "wait." 

d.  If  an  unrecoverable  error  is  detected  on  the 
"RCVMSG"  or"GETMSG"  IPC  calls,  the  AP  Interface 
generates  and  sends  a  status  message  to  the  Monitor 
AP,  and  returns  a  failure  status  to  the  AP. 

e.  Figure  4-19  depicts  the  roles  of  the  AP,  the  AP 
Interface  and  the  MPU  on  a  "RCV"  (with  wait) 
request  from  an  AP.  Note  that  events  la  and  lb 
occur  asynchronously. 


4-72 


DS  620342000 
30  September  1990 


AP 


AP  Interface 


MPU 


la.  The  AP  issues  an 
NTM  service 
request , 

CALL  "RCV"  with  a 
the  wait  indicated 


2  . 


o 


o 


3  . 


4 .  The  AP  receives  back 
control,  its  data, 
and  the  "RCV"  call 
arguments 


lb.  As  the  MPU 
messages  for 
the  AP,  it 
delivers  the 
message  to  the 
AP's  mailboxes 
If  the  AP's 
mailbox (es) is 
full,  the  MPU 
queues  the 
message  for 
later  delivery 

The  AP  interfaces 
responds  to  the  AP ' s 
"RCV"  request,  by 
First  searching  the 
AP's  buffer  for  a 
message  of  the  type 
requested 
If  the  request 
message  is  not  found, 
the  AP  Interface  reads 
the  AP's  mailbox 
indicated  by  the  "RCV" 
request  until  the  mail¬ 
box  is  either  empty  or 
a  message  of  the  type 
requested  is  found. 

(The  sequence  of  IPC 
calls  is  RCVMSG,  WAIT; 
then  on  a  mailbox  event, 

GETMSG . ) 

On  finding  a  message  of 
the  type  requested,  the 
AP  Interface  strips  the 
NTM  header  from  the 
message  and  returns  the  AP's 
data  and  required  "RCV" 
return  arguments  to  the  AP. 


Figure  4-19. 


A  "RCV"  ('with  v.'ait)  AP  Scenario 
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4 . 2 . 9 . 2  Outputs 

Description  Destination  Range 


OS  Process  Control  Host  Operating  System 

Requests  (via  IPC 

Primitives) 


Service  Calls  Return  AP 
to  the  Requesting  APs 
(Messages  to  the  on- 
cluster  AP) 


APC  Message  Queue  Internal  Tables 

Updates 


Status  Message  Manage  Message 

to  Monitor  AP  and 
and  Source  MPUs 


IPC  Primitives: 
"SNDMSG" 

"RCVMSG" 

"GETMSG" 

"WAIT" 

"SETTIM" 

NTM  service 
calls : 

Call  "RCV" 

Call  "CHKMSG" 
returns 

Messages  for  APs 
whose  mailboxes 
were  full  on 
a  "SNDMSG" 
request  - 
delivery  to  be 
retried  at  queue 
check  time 

Error  messages: 
Unrecoverable 
errors  on  IPC 
Pimitives 


4.2.10  Accept  Requests  from  Application  Process 

The  Accept  Requests  from  Application  Process  function  is 
responsible  for  accepting  and  servicing  AP  Service  Requests. 
The  Service  Requests  that  an  AP  may  use  are  described  in  the 
IISS  Programmers  Guide  [8]. 

4.2.10.1  Inputs 

Inputs  to  this  function  are  as  follows. 
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Description 

Source 

Range 

NTM  Service  Request 
Arguments  [8] 

AP 

[8] 

OS  Process  Control 
Response 

Host  Operating  System 
(possibly  via  an  IPC 
Primitive) 

Reponses  on 

IPC  Primitives 

Send  Status  Responses 

Manage  Message 

"Message 
Accept"  or 
"Message 
Reject" 

responses  from 
MM 

APC  Tables 

Internal  Tables 

AP  Status 

Table 

AP 

Characteristic 

Table 


4.2.10.2  Processing 

On  an  AP's  NTM  Service  request  ([8]  and  Figure  4-20)  the 
called  AP  Interface  routine  begins  execution,  accepts  the 
arguments  of  the  Service  call  and  begins  the  servicing  of  the 
requests.  The  connection  and  communication  requests  with  the 
resulting  AP  Interfaces  actions  are  described  in  Figure  4-19. 

For  all  of  the  Services,  an  unrecoverable  error  results  in  a 
"failure"  status  return  to  the  AP  and  a  message  to  the  MONITOR 
AP  that  indicates  the  error  condition.  ERRPRO  is  called  if  the 
status  message  cannot  be  delivered  to  the  MPU ' s  mailbox(es). 

The  NTM  Request  Services  can  obtain  status  information  from 
APC  tables  (WHATAC,  PRSTAT,  GDSTAT) ,  cause  request  messages  to 
be  sent  for  IISS  status  (APSTAT,  HSTATS ,  WHTHST,  ACSTAT,  GETUSR) 
and  cause  messages  to  be  sent  to  effect  the  AP's  request 
(SIGABT,  WKONCA) . 
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NTM  AP  Interface 
Services 


INITIAL 


TRMNAT 


ENDRCY 


NS  END 


Figure  4-20. 


AP  Interfaces  Processing 


o  Maps  to  the  APC  tables 
o  Determines  the  AP's  NTM  given  process 
name 

o  Creates  the  AP's  required  input  mailboxes 
using  the  AP's  process  name  as  the 
mailbox  name 

o  Establishes  the  AP's  message  buffer  area 
o  Establishes  the  IISS  Exception  Handler 
for  the  AP 

o  Sends  an  "I'm  Alive"  message  to  the  local 
MPU 

o  Waits  for  the  "System-State"  Message  from 
the  MPU 

o  On  receiving  the  System-State  message,  it 
completes  mailbox  processing  and  returns 
control,  the  System  State,  and  the 
Startup  Status  to  the  AP 

o  Sends  an  "I'm  Dying"  message  to  the  local 
MPU 

o  Disconnect  the  AP's  input  mailboxes 
o  Ends  the  execution  of  the  AP 

o  Sends  a  "Recovery  Complete"  message  to 
the  Monitor  AP 

o  Returns  control  to  the  AP 

o  Accepts  the  data  and  calling  arguments 
from  the  AP 

o  Formulates  NTM  message (s)  that  includes 
the  correct  NTM  header  and  the  AP's  data. 
The  data  may  be  packetized  into  several 
NTM  messages  if  it  is  longer  than  the 
maximum  NTM  message  data  length.  The 
packetizing  of  continuation  messages  is 
transparent  to  the  AP. 
o  Sends  the  message,  using  the  IPC 

primitive,  "SNDMSG",  to  the  correct  MPU 
mailbox.  If  the  MPU ' s  mailbox  is  full,  it 
resends  the  message  until  the  send  is 
successful . 

NTM  Service  Call  AP  Interface  Processing 
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CDS END 


ISEND 


QSEND 


o  If  NTM  header  processing  is  required,  it 
waits  for  the  return  status  on  message 
acceptance  from  Manage  Message, 
o  On  receipt  of  the  message  send  status  or 
if  no  header  processing  is  required, 
returns  control  to  the  AP  with  the 
correct  status  returns. 

o  Same  as  NSEND,  except  that 
o  GDSEND  causes  the  resulting  message  to  be 
one  of  Category  A 

o  On  acceptance,  returns  control  and  the 
message  serial  number  to  the  AP  so  that  a 
future  status  inquiry  on  the  GD  message 
may  be  made 

o  Same  as  NSEND,  except  that 
o  ISEND  causes  the  resulting  message  to  be 
a  Category  H  or  J  message 

o  Same  as  NSEND,  except  that 
o  QSEND  is  only  used  by  Queue-Server  APs 
o  QSEND  sends  the  "reply"  message  to 
exactly  the  last  instance  of  the 
Destination  from  which  we  had  received 
from  last.  If  we  have  not  received  from 
our  destination  AP,  we  cannot  send  this 
reply  message. 


Figure  4-2C. 


NTM  Service  Call  AP  Interface  Processing 
( Continued) 
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NTM  AP 
Servic' 


CHKMSG 


SETDLY 


GDACK 


MSGACK 


RCV 


F 


Interface 

s  AP  Interfaces  Processing 


o  Checks  the  AP's  buffer  for  a  message  of 
the  requested  type 

o  If  not  found,  reads  the  AP's  input 
mailbox (es)  until  empty  or  until  the 
correct  message  type  is  found 
o  Returns  the  appropriate  status  to  the  AP 
either  "message  found"  or  "message  not 
found" 

o  Checks  the  validity  of  the  call's  message 
delay  arguments 

o  If  valid,  saves  the  arguments  for  the 

header  for  the  next  "NSEND",  "GDSEND",  or 
"ISEND"  call's  message  and  returns  to  the 
AP 

o  If  not  valid,  returns  to  the  AP  with  a 
no-accept  status 

o  Accepts  the  input  arguments  from  the  AP 
o  Formulates  an  NTM  message  of  type  GDACK 
for  the  MPU  of  the  originating  GD  message 
o  Delivers  the  message  to  the  local  MPU's 
mailbox 

o  Returns  control  to  the  AP 

o  Same  as  GDACK,  except  that  the  message 
destination  is  the  AP  that  sent  the 
message  requiring  the  ACK. 

o  Accepts  the  input  arguments  of  the  RCV 
call 

o  Checks  buffer  and  AP's  mailbox  for  the 
message  requested.  (See  [8]  for  the  AP's 
request  options.) 

gure  4-20.  NTM  Service  Call  AP  Interface  Processing 
( Continued) 
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r.'TM  AP  Interface 
Services 


RCV  (Continued) 


TSTMOD 


SIGERR 


A PS TAT 


Figure  4-20. 


AP  Interface  Processing 


o  If  found,  the  AP  Interface  strips  the  NTM 
header  from  the  AP ' s  message  and  returns 
that  data  and  return  arguments  to  the  AP. 
o  If  the  requested  message  is  not  found  and 
a  wait  was  requested  by  the  AP  the  AP 
Interface  waits  until  a  mailbox  event  is 
signaled.  It  then  performs  the  previous 
step . 

o  If  the  requested  message  is  not  found  and 
no  wait  was  signaled,  the  API  returns 
control  to  the  AP  with  a  "No  Message" 
status 

o  Checks  the  TSTMOD  argument 
o  If  it  signals  'ON',  all  asynchronous 

error  messages  sent  after  will  be  passed 
to  the  AP. 

o  If  it  signals  'OFF',  all  messages  sent 
after  will  be  discarded 
o  The  default  TSTMOD  setting  is  "Off"  or 
"0" 

o  Formats  the  Signal  Error  (SE)  message 
using  the  given  AP  Name  and  AP  Error 
Code,  severity  level,  and  error 
description . 

o  Sends  the  SE  message  to  the  original 
source  AP  (typically  the  UI)  and  to  the 
monitor  AP. 

o  Formats  the  AP  Status  Request  (SR) 
message  using  the  given  AP  Name, 
o  Forwards  the  SR  message  to  the  NTM  for 
processing  (if  AP  is  local  -  Read  APS 
table,  if  AP  is  off-cluster  -  forward 
message  to  appropriate  MPU) . 
o  Receives  the  AP  Status  Return  (IS)  from 
the  NTM 

o  Passes  the  AP  Status  data  to  the 
requesting  AP. 

NTM  Service  Call  AP  Interface  Processing 
( Continued) 
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NTM  AP  Interface 
Services 


AP  Interface  Processing 
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HSTATS 


WHTHST 


WHATAC 


WKONCA 


Figure  4-20. 


o  Formats  the  Host  Status  Reguest  (HR) 
message  using  the  given  Host  Name, 
o  Forwards  the  message  to  the  local  MPU  for 
processing  (read  Host  Status  Table), 
o  Receives  the  Host  Status  Return  (HO) 
message  from  the  Local  MPU. 
o  Passes  the  Host  Status  Data  to  the 
requesting  AP. 

o  Formats  the  Host  Name  Request  (HN) 

message  using  either  the  given  AP  Name  or 
the  name  of  the  AP  to  which  the  service 
is  currently  bound. 

o  Forwards  the  message  to  the  NTM  for 
processing  (Read  API  and  APC  Tables) . 
o  Receives  the  Host  Name  Return  (NH)  or 
processing  error  message  from  the  Local 
MPU. 

o  Passes  the  Host  Name  to  the  requesting 
AP. 

o  Formats  the  APC  Name  Request  (AN)  message 
using  either  the  given  AP  Name  or  the 
name  of  the  AP  to  which  the  service  is 
currently  bound. 

o  Forwards  the  message  to  the  Local  MPU  for 
processing  (read  AP  Information  Table) . 
o  Receives  the  APC  Name  Return  (NA)  message 
from  the  local  MPU. 

o  Passes  the  APC  Name  to  the  requesting  AP. 

o  Formats  the  APC  Availability  Request  (AV) 
message  using  the  given  APC  Name, 
o  Forwards  the  message  to  the  local  MPU  for 
processing . 

o  Receives  the  APC  Available  Return  (VR) 
message  from  the  MPU. 

o  Passes  the  relevant  return  status  to  the 
requesting  AP. 

NTM  Service  Call  AP  Interface  Processing 
( Cont i nued) 
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ACSTAT  o  Formats  the  APC  Status  Rquest  (PS)  using 

the  given  APC  Name. 

o  Forwards  the  message  to  the  Local  MPU  for 
processing  (read  APC  Status  Table), 
o  Receives  the  APC  Status  Return  (PR) 
message  from  the  MPU. 
o  Passes  the  APC  status  data  to  the 
requesting  AP. 

Formats  the  Abort  AP  (AB)  message  using 
the  given  AP  Name  and  logical  channel. 
Forwards  the  message  to  the  Local  MPU  for 
processing  (process  message  and  send  to 
given  AP) . 

Figure  4-20.  NTM  Service  Call  AP  Interface  Processing 

( Continued) 


SIGABT  o 

o 
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NTM  AP  Interface 

Services  AP  Interface  Processing 


o  Returns  the  sending  status  of  the  message 
to  the  requesting  AP.  Note:  the  API  does 
not  return  the  status  of  the  Abort 
procedures  in  this  call. 

PRSTAT  o  Formats  the  Paired  Message  Status  Request 

(MS)  message  using  the  given  message 
destination  and  logical  channel, 
o  Forwards  the  message  to  the  Local  MPU  for 
processing  (Read  Message  Pair  Table) . 
o  Receives  the  Paired  Message  Status  Return 
(MR)  message  from  the  Local  MPU. 
o  Passes  the  Paired  Message  Status  to  the 
requesting  AP. 

GDSTAT  o  Formats  the  GD  Status  Request  (GS) 

message  using  the  given  Message  Serial 
Number . 

o  Forwards  the  message  to  tiie  local  MPU  for 
processing  (Read  GD  Table), 
o  Receives  the  GD  Status  Return  (GR)  from 
the  Local  MPU 

o  Passes  the  GD  message  status  to  the 
requesting  AP. 

GETUSR  o  Locates  the  original  source  AP  Name. 

o  If  r.he  original  source  AP  is  a  user 

interface;  accesses  the  Logon  Table  to 
determine  the  user  logon  data, 
o  Returns  the  original  source  data  to  the 
requesting  AP. 


Figure  4-20.  NTM  Service  Call  AP  Interface  Processing 

( Cont inued) 
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4.2.10.3  Outputs 

Description  Destination  Range 


Messages  to  be 
Routed 

OS  Requests 
(IRC  Primitives) 


AP  Initiation 
Requests 

AP  Termination 


Manage  Message 

Host  Operating 
System 


All  message 
types 

IPC  Primitive: 
"SNDMSG" 
"GETMSG" 
"RCVMSG" 

"WAIT" 

"SETTIM" 


Initiate  Application  NTM  Service 
Process  "INITIAL" 


Terminate  Application  NTM  Service 

"TRMNAT" 


4.2.11  Terminate  Application  Process  Function 

The  Terminate  Application  Process  function  is  responsible 
for  terminating  or  signaling  shutdown  to  an  application  process. 

4.2.11.1  Inputs 

Inputs  to  this  function  are  as  follows: 

Description  Source  Range 


AP  Termination  Accept  Requests 

from  "TRMNAT"Request  AP 


Messages  for 
On-Cluster 


Terminate  AP 
Status  Response 


Interpret  Message  "I'm  Dying" 

Category  message 

from  AP 
"Shutdown  AP" 
message  "Abort 
AP"  message 


Host  Operating  System 


Status  msg 
indicating 
status  of  Abort 
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Description  Source  Range 


AP  request 

APC  Tables  Internal  Tables  AP  Status  Table 

AP  Child  Table 
AP  Characteris¬ 
tic  Table 

4.2.11.2  Processing 

Abnormally  Terminate  or  Shutdown  AP 

Upon  receipt  of  an  "abort  AP"  or  "shutdown  AP"  request  the 
SIBABT  service  shall: 

a.  Check  the  AP  Information  Table  to  determine  if  the 
targeted  AP  resides  on  the  current  MPU. 

If  the  targeted  AP  resides  on  another  MPU, 
the  destination  of  the  message  is  changed  to  the 
MPU  the  AP  resides  on,  and  the  message  is  sent  to 
that  MPU. 

b.  Check  the  AP  Status  Table  to  determine  if  the  targeted 
AP  has  an  entry. 

If  AP  status  table  has  an  entry  but  the  AP  has  already 
terminated,  the  NTM  sends  an  "AP  Terminated"  message 
to  the  MPU  which  originated  the  request. 

If  the  targeted  AP  has  an  entry  in  the  AP  Status  Table 
but  is  in  termination,  an  "Abort  AP"  message  is  sent 
to  the  MPU  of  each  alive  child  of  the  target  AP. 

If  the  target  AP  has  an  entry  and  is  initiation,  the 
MPU  will  change  the  AP  Status  Table  entry  to  "init 
cancelled".  When  the  "I'm  Alive"  is  received,  the  NTM 
terminates  the  target  AP,  and  then  sends  an  "AP  dying" 

c.  If  the  target  AP  has  an  entry  in  the  AP  Status  Table 
executing,  then  the  NTM  will  check  the  AP 
characteristic  Record  to  determine  the  action  to  take. 


4-84 


DS  620342000 
30  September  1990 


If  the  AP  characteristic  table  entry  show  the  target 
AP  expects  a  "request  to  abort  message",  then  the  NTM 
should  send  the  message  to  the  target  application  and 
take  no  further  action. 

If  the  AP  characteristic  table  entry  indicates  an 
abort  is  required,  the  MPU  will  terminate  the  target 
AP.  The  MPU  then  will  send  itself  an  "AP  Dying" 
message  on  behalf  of  the  aborted  AP.  If  the  aborted  AP 
message  is  sent  to  the  MPU  of  each  alive  child  to 
abort  it. 

If  the  AP  characteristic  table  entry  indicates  the  AP 
expects  to  run  to  completion,  then  no  action  is  taken. 

d.  On  termination,  the  aborted  AP's  process  status  is 
updated  to  "aborted".  A  "child  status"  message  is  sent 
to  the  parent  AP.  If  the  abort  request  is  from  the 
operator,  then  an  "ACK"  should  be  sent  to  the  MONITOR 
AP  for  the  operator"s  console. 

e.  On  the  receipt  of  a  "child  status  AP  aborted"  message, 
the  receiving  NTM: 

Checks  the  status  of  the  parent  APand,  if  running, 
checks  the  parent's  AP  Characteristic  Record  to 
determine  whether  to 

o  send  an  "aborted  child"  status  message  to  the  AP, 
o  abort  the  parent  AP, 

o  let  the  parent  AP  continue  and  not  send  it  a  status 
message . 

In  addition,  the  NTM  of  the  parent  AP  updates  the  child 
table  of  the  parent  AP  to  indicate  the  new  status  of  the 
aborted  AP. 
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On  receipt  of  a  child  status  message  that  indicates  the 
completion  of  one  branch  of  the  APs  child  tree,  the  NTM 
checks  to  see  if  all  children  of  a  terminated  AP  are 
also  terminated.  The  NTM  of  the  AP  sends  a  cleanup 
message  to  the  NTM  of  each  AP  in  its  child  tree  and  then 
removes  the  AP's  entry  from  the  Process  Status  Table  and 
its  Child  Table  entries. 

On  the  receipt  of  a  "cleanup"  message,  the  receiving 
NTM,  removes  the  designated  AP's  entries  in  the 
Application  Process  Status  Table  and  associated  child 
table . 

Where  the  IISS  state  is  "IISS  shutdown,"  no 
acknowledgement  or  child  abort  processing  is  performed 
on  the  Abort  AP  or  Shutdown  AP  message  .  It  is  assumed 
that  each  APC  v;ill  do  its  own  AP  shutdown  and  cleanup. 

If  the  IISS  state  is  "Host  Shutdown"  or  "APC 
Shutdown",  on  the  Abort  AP  or  Shutdown  AP  message, 
acks  and  child  abort  notifications  are  sent,  but 
shutdown  proceeds  without  waiting  for  any  child  status 
or  cleanup  messages. 

No  messages  are  sent  to  APC ' s  or  hosts  in  shutdown 
state . 

If  the  AP  is  of  the  type  "Run  to  Completion,"  it  is 
allowed  to  complete  if  the  IISS  is  not  in  APC,  HOST, 
or  IISS  Shutdown  mode. 
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+ 


- + 

+ - >AP3  (running) 

API - >AP2 - + - >AP4  (terminated) 

(running)  (aborted)  j 

+ - >AP5  (running) 

- + 


X  « 
2  . 

3  . 

4  . 


6  . 


7  . 


AP2  is  aborted  by  its  MPU 

API's  MPU  sends  a  child  status  (abortack)  to  AP2's 
parent  with  the  status  of  AP2 ' s  child  tree  (children 
running) 

NTM  sends  ABORT  messages  to  AP3 ' s  and  AP5 ' s  MPUs 


API's  NTM  updates 

4 ' .  AP3  and  API ' s 

child  table  to 

APS  are  indicate 

"child  aborted 

abortea 

v.’ith  children 

S'.  Child  status 

active,"  on  receiving 
the  child  status 

messages  are 
sent  to  message 

AP2 

AP2 ' s  MPU 

AP2's  NTM  receives  both  child  status  msgs  from  AP2  & 

AP3  that  indicates  their  terminations,  updates  its  tables 
sends  cleanup  messages  to  AP2  and  AP3's  NTMs,  and  sends  a 
"children  terminated"  message  to  API's  MPU 

API's  characteristic  record  is  checked  to  determine  what 
action  should  be  taken  on  the  child  status  message  from 


AP2 

If  API  is  to  be 
aborted:  the  NTM 
aborts  API  and  sees 
that  its  child  tree 
in  the  process  of 
terminating,  so 
v/aits  for  child 
status  messages  that 
indicate  completion 
of  the  tree 


7 ' .  AP2  &  AP3 's 
NTMS  remove 
the  process 
status  and  is 
child  table 
entries  for 
AP2  &  AP3 


Figure  4-21.  NTM  Abort  AP  Protocol 
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8.  On  receiving  the 

"children  terminated" 
message  from  AP2 ' s 
NTM,  API's  NTM 
removes  API's  table 
entries  and  sends 
a  cleanup  message 
to  AP2 ' s  NTM 

Figure  4-21.  NTM  Abort  AP  Protocol  (Continued) 


9.  AP2 ' s  NTM  receives 
the  cleanup  message 
from  API's  MPU  and 
removes  its  table 
entries  for  AP2 
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Normal  Termination 


Upon  receipt  of  an  "I'm  Dying"  message  from  an  AP,  the  NTM 
sends  a  child  status  message  to  the  NTM  of  the  parent  (or 
spavmer)  of  the  terminated  AP.  Child  table  processing  and 
cleanup  continues  as  indicated  in  Figure  4-22. 


4-8  9 


DS  620342000 
30  September  1990 


spawns  + 

API - >AP2 - + 

terminates+ 


1.  AP2  terminates  -  sends  "I'm  Dying"  message  to  its  NTM 

2.  NTM  of  AP2  sends  child  status  message  to  API  indicating  AP2 
normal  termination  with  children  active 

3.  NTM  of  API  receives  child  status  message  from  AP2 ' s  NTM. 
Checks  to  see  if  API  gets  informed  of  event  and  handles 
this  appropriately. 

4.  NTM  of  API  updates  API's  child  status  table 

5.  AP3  and  AP4  terminate,  send  status  messages  to  the  NTM  of 
AP2 

6.  NTM  of  AP2  receives  child  termination  messages,  sees  that 
child  tree  is  complete  removes  its  entries  for  AP2  and 
sends  status  msg  to  API's  NTM. 

Figure  4-22.  NTM  -  Normal  AP  Termination  Protocol 


>AP3 

>AP4 

- + 
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7.  NTM  of  API  receives  the  status  message,  and  on  termination 
of  API  and  completion  of  all  API's  children,  API's  NTM 
sends  a  cleanup  message  to  NTM 

NTM  of  AP2  sends  a  cleanup  message  to  AP3  and  AP4 ' s  NTM's 
AP3  and  AP4 ' s  NTM  remove  all  AP3  and  AP4  table  AP2 ' s 
entries 

10.  NTM  of  AP2  receives  &  processes  its  cleanup  message 
Figure  4-22.  NTM  -  Normal  AP  Termination  Protocol  (Continued) 
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4.2.11.3  Outputs 

Description  Destination  Range 


OS  Requests  to  Abort 
APs 


Messages  to  be 
Routed 


APC  Table  Updates 


Host  Operating  System 


Manage  Message 


Internal  Tables 


Operating  System 
dependent  process 
termination 
requests 

"I'm  Dying" 
message  from 
terminating  AP 

Child  status 
messages  to 
NTMs  of 
terminating 
AP's  parent 

Cleanup  messages 
to  NTM  of  child 
APs. 

AP  Process  Table 
Child  Table 


4.2.12  Handle  System  Commands 

The  Handle  System  Command  function  is  responsible  for 
processing  commands  from  the  Monitor  AP  for  the  APC. 


4.2.12.1  Inputs 

Inputs  to  this  function  are  as  follows: 

Description  Source 

Messages  for  Maintain  Manage  Message 

(APC)  Operability 

(MO) 


Range 

"Shutdown  APC" 
"Shutdown  AP" 
"Display  Active 
APs"  "Recover 
APC"  (TBD) 
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Description 
OS  Responses 


Host  Tables 


ARC  Queues  and 
Tables 


Source  Range 

Host  Operating  System  ARC  Startup 

Responses  to 
"Get  ARC  name 
request" 
Response  to 
"Map  to  Host 
Tables  Request" 

Internal  Tables  Message 

Definition 
ARC,  Host 
Status  Tables 


Internal  Tables 


All  ARC  Tables 


4.2.12.2  Rrocessinq 


The  Handle  System  Command  function  processes  the  IISS 
System  Commands  from  the  Monitor  AR  according  to  the  following 
procedures . 


System  Command 
START  ARC 


Shutdov;n  AR 


NTM  Rrocessinq 

1.  Gets  the  MRU's  process  name. 

2.  The  MRU,  on  startup,  maps  to  the  host 
tables  that  are  maintained  by  the 
Monitor  AR. 

3.  Creates  the  MRU's  high  and  low 
priority  input  mailboxes  using  is 
process  name  concatenated  with  "H"  and 
"C"  for  the  mailbox  names. 

4.  If  steps  1-3  are  successful,  the  MRU 
sends  a  "Table  Configuration  Status 
Request"  to  the  Monitor  AP.  If  steps 
1-3  have  failed,  it  sends  a  startup 
fail-status  message  to  the  Monitor  AR. 
If  it  cannot  send  a  message  to  the 
Monitor  AR,  it  calls  ERRRRO  and 
terminates . 

5.  If  processing  is  still  successful,  the 
MRU  waits  for  a  "Table  Status"  message 
from  the  Monitor  AR. 

6.  The  remaining  startup  protocol  is 
described  in  Figure  4-23 

See  4.2.11.2 


Shu tdo'wn  ARC 


1.  Sets  ARC  Shutdown  flag. 
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2.  Does  abort/shutdown  processing  for 
each  AP  in  AP  Status  Table 
(4.2.11.2.1) 

3.  Processing  continues  until  the 
mailboxes  are  empty  and  all  AP ' s  are 
dead . 

4 .  Saves  queues 

5.  Saves  initialization  data. 

6.  Deletes  mailboxes. 

7.  Sends  "APC  Terminating"  message  to  the 
Monitor  AP. 

8 .  Terminates 
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MPU  (after  being  initiated)  Monitor  AP 

1.  Sends  "Table  Status  Request" 
message  and  waits  for  return 
message . 

2a.  On  receipt  of  message,  and 
if  tables  are  OK  sends 
"Tables  OK"  message  to  MPU 

2b.  On  receipt  of  massage  and 
tables  not  OK,  sends 
"Tables  Not  OK"  message  to 
MPU 

3a.  On  receipt  of  "Tables  OK" 
message,  reads  local  files 
to  build  tables, 
o  If  table  read  is  successful, 

sends  "APC  Alive"  message  to  Monitor 
o  If  table  read  fails,  sends 
"Table  Access  Failure" 
message  to  monitor 
o  If  return  message  times  out, 
the  APC  will  terminate. 

3b.  On  receipt  of  "Tables  NOT" 
message,  requests  COM  data 
and  sends  either  success 
or  failure  message  to  the 
Monitor  AP  on  completion 

4a.  On  "APC  Alive"  message, 
updates  APC  status  to 
running,  and  sends 
'Host  Active'  message  to 
the  APC 

4b.  On  "Table  Access  Failure" 
message,  monitor  updates 
APC  status  to  "down"  and 
notifies  operator  of 
condition . 

5a.  On  receipt  of  the  'Host 
Active'  message  fromm  the 
Monitor  AP,  it  sets  its 
status  from  'startup'  to 
'running'.  Normal  proces¬ 
sing  can  now  begin. 

5b.  If  the  return  message  times 
out,  the  APC  will  terminate. 

Figure  4-23.  APC  Startup  Protocol 
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System  Command 
Display  Active  APs 


NTM  Processing 

1.  Creates  a  message  with 
information  about  each 
active  AP  on  its  AP  Cluster 

2.  Delivers  the  message  to 
Monitor  MPUs  mailbox 


4.2.12.3  Outputs 

Description  Destination  Range 


Response  Messages 
to  Monitor  AP 


APC  Tables  &  Queue 
Updates 

Queue  Requests 


Manage  Messages 


Internal  Table 

Handle  APC  Message 
Queues 


Messages : 
"Table  Status 
Request" 

"APC  termina¬ 
ting" 

"APC  Alive" 
"Active  APs" 
"Error  Condi¬ 
tions" 

"Table 

Requests" 

All  APC  Tables 


"Initiate";  Re¬ 
cover  (TBD) , 
Save  Queues 


4.2.13  Handle  APC  Message  Queues 

The  Handle  APC  Message  Queues  function  is  responsible  for 
maintaining  the  APC  message  queues. 


4.2.13.1  Inputs 

Inputs  to  this  function  are  as  follows. 
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Description 

Source 

Range 

Queue  Requests 

Handle  System  Command 
Function 

Initiate , 
Recover  (TBD) , 
Save  Queues 

OS  Responses 

Host  Operating  System 
(IPC  Primitives) 

Time  out  Event 
Responses  on 
"SNDMSG"  IPC 

Host  Tables 

Internal  Tables 

APC  Status 
Table , 

Host  Status 
Table 

APC  Tables 

Internal  Tables 

All  APC  Tables 
&  Queues 

Message  Category 
Table 

Internal  Tables 

A-J 

4.2.13.2  Processing 

There  are  two  types  of  message  queues  within  the  IISS; 
off-cluster  and  on-cluster.  Each  queue  is  used  to  hold  messages 
that  cannot  be  sent  due  to  a  destination  mailbox  full  condition. 
Guaranteed  Delivery  messages  are  the  only  messages  queued  if  the 
destination  is  otherv/ise  unavailable. 

Both  types  of  queues  operate  on  a  first-in-first-out  basis 
(FIFO).  Their  entries  are  kept  in  index-sequential  order  with  the 
local  APC  name  as  an  integral  part  of  the  primary  key.  Unique 
processing  for  each  queue  type  is  described  below. 

1.  Off-Cluster  Queue:  When  the  MPU  has  a  message  for  another 
APC,  it  will  check  the  AP  Cluster  Status  table  to 
determine  the  status  of  the  destination  APC.  If  the 
destination  APC  is  not  available,  a  status  message  is  sent 
to  the  message  source  AP  and  to  the  Monitor  AP.  If  the 
message  is  Guaranteed  Delivery,  it  will  be  queued  in  the 
off-cluster  queue.  Otherv/ise,  the  message  is  lost. 

If  the  destination  APC  is  active,  the  MPU  will  attempt  to 
place  the  message  in  the  destination's  mailbox.  If  the 
mailbox  is  full  the  message  is  queued.  On  the  MPU ' s  timer 
processing,  the  queue  is  checked  for  extent  messages.  If 
any  are  found,  the  send  will  again  be  attempted  until  the 
queue  is  empty  or  the  mailbox  is  full. 

2.  On-Cluster  Queue:  When  a  message  has  been  accepted  for 
delivery  to  an  on-cluster  AP,  the  queue  is  checked  for 
extent  messages  to  the  destination  that  have  yet  to  be 
delivered.  Any  messages  already  in  queue  will  be 
delivered  first  to  ensure  serial  processing.  Messages  will 
be  placed  in  the  AP's  mailbox  until  all  messages  are 
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delivered  or  the  AP ' s  mailbox  is  full.  On  a  mailbox  full 
or  AP's  initiating  condition  the  messages  will  be  queued. 
The  on-cluster  queue  is  periodically  checked  as  part  of 
the  MPU ' s  timer  processing. 


4.2.13.3  Outputs 

Description 

Destination 

Range 

Updated  Queues 

Internal  Tables 
message 

MM  &  MP 
Queues 

Messages  to  On- 
cluster  APs 

Deliver  Message 
to  AP 

All  message 
categories 
for  APs 
time-out 
messages 

Messages  for  Off- 
cluster 

Manage  Message 

All  message 
categories 

Status 
messages  to 
Monitor  AP 

OS  Process  Control 
Requests 

Host  Operating  System 

"SNDMSG"  IPC 
Primitives 

OS  file 

handling 

commands 


4.2.14  Handle  Local  APC  Tables  Function 

The  Handle  Local  APC  Table  function  is  responsible  for 
maintaining  the  APC  tables. 
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4.2.14.1  Inputs 

Inputs  to  this  function  are  as  follows: 

Description  Source  Range 


Table  Requests 


OS  Responses 


Message  Category 
Table 

Host  Tables 


ARC  Local  Tables 


Handle  System  Command 
Function 


Host  Operating  System 
(IPC  Primitives) 


Internal  Tables 


Initiate, 
Recover  (TBD) , 
Terminate 

Time-out  Event 

Responses  on 
"SNDMSG”  IPC 

Response  on 
"ABORT  AP 
Requests 


A-J 


Internal  Tables  APC  Status  Table 

Host  Status 
Table 

Internal  Tables  All  APC  Tables 


4.2.14.2  Processing 

APC  Tables  are  maintained  by  the  following  processing: 
Event  Processing 


APC  Startup  All  APC  Local  Tables  are  initialized 

and  built  from  local  files  or  from 
CDM  data  depending  on  Monitor's 
start  table  command  (4.2.12.2) 

rime-out  The  following  APC  Dynamic  Tables  are 

processed  on  a  time-out  event. 
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Event 


Processing 


Time-out  (Continued) 


APC  Shutdown 


1.  Message  Pairing  Tables  -  the 
pair  table  on  the  APC  is 
checked  for  messages  whose 
timeouts  have  expired.  On 
expired  messages,  the  AP 
characteristic  record  of  the 
waiting  AP  is  checked  to 
determine  whether  the  AP  should 
receive  a  time-out  message  or 
be  aborted.  The  appropriate 
action  is  taken  by  the  MPU. 

2.  Guaranteed  Delivery  Table  -  the 
guaranteed  delivery  table 
entries  are  checked  to  see  if 
an  ACK  from  the  next  receiving 
MPU  has  been  received.  If  the 
table  indicates  no  response  to 
the  GD  message,  a  status 
request  is  sent  to  the  MPU  from 
which  a  response  is  due. 

If  the  table  indicates  an 
expired  time  with  no  response 
to  a  GD  status  request  from  an 
MPU  that  has  been  sent  a  status 
request,  a  status  message  is 
sent  to  the  Monitor  AP. 

3.  "I'm  Alive"  table  -  these  table 
entries  are  checked  for  entries 
with  elapsed  time-outs.  Those 
entries  will  cause  an  "Init 
failure"  message  to  be  sent  to 
the  Monitor  AP  and  the  MPU  from 
which  the  AP  initiation  request 
was  sent. 

1.  GD  Tables  are  saved 

2.  APC  Files  are  closed 
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Status  Messages 

Messages  to  On- 
cluster  AP 

APC  Tables 


Destination 

Manage  Message 
messages 

Deliver  Message  to 
AP 

Internal  Tables 


Range 


Status 

to  MONITOR  AP 
and  to  MPUs 

Time-out 

messages 

All  APC  Tables 
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4 . 3  Special  Requirements 

4.3.1  Programming  Methods 

NTM  programming  methods  shall  conform  to  the  standards  set 
forth  by  General  Electric  in  the  IISS  Software  Development 
Guidelines/Conventions  document  [10]. 

4.3.2  Program  Organization 

This  paragraph  is  not  applicable  to  the  NTM  CPCI . 

4.3.3  Modification  Consideration 


This  paragraph  is  not  applicable  to  the  NTM  CPCI. 

4.3.4  Special  Features 

To  facilitate  the  testing  of  the  NTM  CPCI,  integrated 
application  processes  must  be  provided  to  act  as  test  drivers. 

4.3.5  Expandability 

The  NTM  will  be  designed  and  implemented  in  a  manner  which 
provides  for  an  expandable  configuration  and  increasing 
functionality.  Additional  APs,  clusters,  hosts,  and  changes  in 
hardware  will  be  accommodated  with  minimal  impact  on  the  user 
and  the  system.  The  use  of  a  High  Order  Language  significantly 
enhances  the  portability  of  the  code.  Host  dependent  code  will 
be  used  only  when  absolutely  necessary.  In  these  cases  the  code 
will  be  identified  and  isolated  to  facilitate  transfer  to  a  new 
host . 

4.3.6  Special  Timing 

This  paragraph  is  not  applicable  to  the  NTM  CPCI. 

4 . 4  Human  Performance 

This  paragraph  is  not  applicable  to  the  NTM  CPCI. 

4 . 5  Data  Base  Reguirements 

4.5.1  Sources  and  Types  of  Inputs 

The  information  identified  as  input  to  the  NTM  and  its 
component  functions  is  defined  in  Section  4.2  above.  The 
identified  data  items  are  thoroughly  defined  in  Appendix  D 
below. 

4.5.2  Destinations  and  Types  of  Output 

The  information  identified  as  output  from  the  NTM  and  its 
component  functions  is  defined  in  Section  4.2  above.  The 
identified  data  items  are  defined  in  Appendix  D  below. 
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4.5.3  Internal  Tables  and  Parameters 

The  tables  required  by  the  NTM  functions  are  discussed 
below.  The  structure  of  the  data  items  used  in  the  tables  are 
identified  in  the  IDEFl  model  in  Appendix  C  below.  These  items 
are  defined  in  Appendix  D  as  to  name,  ID,  description,  COBOL 
Picture,  size,  coding  type,  IDEFl  reference,  stability  (static 
vs.  dynamic),  legal  values,  source,  and  where  used. 

Figure  4-24  provides  an  overview  of  the  tables  used  by  the 

NTM. 
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Table 

Name 

Table 

ID 

Table 

Location 

Entry 

Length 

No .  of 
Entries 

Size 

Message 
Category 
Table 
(4. 5. 3.1) 

CAT 

Global-IISS 

X(7) 

10 

70 

bytes 

Authority 

Table 

(4 . 5. 3 . 2) 

AUT 

Local  to 

APC  (Based 
on  resident  AP's 
authority  to  send) 

X(22) 

Variable 
per  table 
instance 

Vari¬ 

able 

AP  Informa¬ 
tion  Table 
(4 . 5. 3 . 3) 

API 

Local  to  APC 

X(14) 

One  per 

AP  known 
to  IISS 

TBD 

(fixed) 

AP  Status 

Table 

(4 . 5. 3 .4) 

APS 

Local  to  AP's 

AP  Cluster 

X(85) 

One  per  Vari- 

initiated  able 

AP  Instance 

Child  Table 
(4 . 5. 3 . 5) 

CLD 

Local  to  Parent 
AP's  AP  Cluster 

X(39) 

One  per 
spawned  AP 

Vari¬ 

able 

AP  Charac- 
istics  Table 
(4 . 5. 3 . 6) 

APT 

Local  to  AP's 

AP  Cluster 

X(24) 

One  per  AP 
on  APC 

TBD 

( fixed) 

APC  Status 
Table 
(4. 5. 3. 7) 

APC 

Global-IISS 

X(7) 

One  per 

APC  known 
to  IISS 

TBD 

( fixed) 

Host  Status 

Table 

(4 . 5. 3 . 8) 

HST 

Global-IISS 

X(7) 

3 

21 

bytes 

Message  Pairing 
Table  MPR 

Local  to  sending 
APC 

X  (44) 

One  per 
msg.  pair 

Vari¬ 

able 

(4. 5. 3. 9) 


Figure  4-24.  NTM  Tables  -  Overview 
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Table 

Name 

Table 

ID 

Table 

Location 

Entry 

Lengch 

No .  of 
Entries 

Size 

Logon  Table 
(4.5.3.10) 

LOG 

Local  to  Monitor 

AP  X(62) 

One 

per 

logged-on 

user 

Vari¬ 

able 

Guaranteed 

Delivery 

Table 

(4.5.3.11) 

GRD 

Local  to  sending 
APC 

X(66) 

One  per  Vari- 

Guar.  able 

Del . 

Msg .  sent 
from  on-APC 

AP 

AP  Operating 

Information 

(4.5.3.12) 

APO 

Local  to  AP's 

AP  Cluster 

X(19) 

One 

per 

AP  on  the 
APC 

Vari¬ 

able 

I 'm  Alive 

Table 

(4.5.3.13) 

I  AT 

Local  to  AP's 

AP  Cluster 

X(18) 

One  per  Vari- 

AP  able 

instance  in 
Initiation 

Mode 

Link  Status 

Table 

(4.5.3.14) 

LST 

Local  to  Monitor 
AP 

X(3) 

One  per 
link 

9 

Authority 
Check  Table 
(4.5.3.15) 

ACT 

Local  to  APC 

X(9) 

One  per 
destina¬ 
tion  AP 

Vari¬ 

able 

Directory 

Table 

(4.5.3.16) 

DIR 

Global  IISS 

X(24) 

One  per  Vari- 

directory  able 
known 

to  the  IISS 

Connection 

Table 

CON 

Local  to  APC 

X(  ) 

One  per  Variable 
Connection 

(4.5.3.17) 

Figure  4-24.  NTM  Tables  -  Overview  (Continued) 


4-105 


DS  620342000 
30  September  1990 


4 . 5 . 3 . 1  Message  Category  Table 

This  table  contains  the  information  relative  to  the 
processing  required  of  the  MPU  in  order  to  move  a  message 
through  the  IISS.  The  categories  are  defined  primarily  in  terms 
of  these  processing  requirements.  A  second,  smaller, 
consideration  in  the  definition  of  the  categories  is  the 
breakdown,  to  a  limited  extent,  based  on  end  processing 
requirements.  This  breakdown  resulted  in  the  separate 
categorization  of  System  Commands  and  AP  Status  Messages. 

The  message  categories  defined  for  the  initial  Test  Bed 

are : 

A  Guaranteed  Delivery 

B  Response  required 

C  System  Command  -  no  response  (to  initiator) 

D  System  Command  -  response  (to  initiator)  required 

E  Unsolicited  Message 

F  Solicited  Message 

G  AP  Status  Message 

H  Initiation  Message  (may  or  may  not  have  data) 

I  Message  from  COMM  AP 

J  Initiation  Message  -  Response  Required 

The  format  and  identified  values  of  the  message  category 
table  are  shown  in  Figure  4-25.  The  individual  fields  are 
defined  below. 


Field 

Field  Name  Field  ID  Size 


Field  Description 


Message  CAT-MSGCAT  X 

Category 


Authorization  CAT-AUTREQ  X 
Requirement 


This  field  contains  a  legal 
value  of  a  message  category. 
The  table  is  indexed  on  this 
field  using  the  value 
contained  in  the  message 
header . 

This  field  identifies 
v/hether  a  message  conforming 
to  a  given  category  requires 
authorization  at  it's  source 
AP  Cluster.  Authorization 
is  defined  as  the 
determination  that  the 
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Field  Name 


Pairing 

Requirement 


Guaranteed 
Del ivery 


Message 

Priority 


Log 

Requirement 


Statistics 

Collection 

Flag 


Field  ID 


Field 

Size  Field  Description 


destination  AP  is  in  fact 
able  to  receive  the  given 
message  type  from  the  source 
AP. 


CAT-PREQMT  X 


CAT-GUARDL  X 


CAT-MSGPRY  X 


CAT-LOGREQ  X 


CAT-STATCO  X 


This  field  identifies 
whether  a  message  conformed 
to  a  given  message  category 
requires  pairing. 

This  field  identifies 
whether  a  message  conforming 
to  a  given  message  category 
rf^'quires  that  an 
acknowledgment  of  delivery 
be  sent  to  the  source  of  the 
message . 

This  field  indicates  the 
level  of  priority  assigned 
to  a  message  conforming  to  a 
given  message  category. 

The  value  of  this  field  is 
added  to  the  message  header 
by  the  MPU. 

This  field  indicates  whether 
logging  is  required  on  a 
message  conforming  to  the 
given  category.  The  value  is 
added  to  the  message  header 
by  the  MPU. 

This  field  indicates  whether 
statistics  are  to  be 
collected  on  a  message  con¬ 
forming  to  the  given  message 
category.  The  value  is  added 
to  the  message  header  by  the 
MPU. 
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Message 

Category 

Author!-  Pairing 
zation  Require- 

Requirement  ment 

Guaranteed 

Delivery 

Message 

Priority 

Log 

Require¬ 

ment 

Statistics 

Collection 

A 

Yes 

No 

Yes 

Low 

Yes 

Yes 

B 

Yes 

Yes 

No 

Low 

Yes 

Yes 

C 

No 

No 

No 

High 

Yes 

Yes 

D 

No 

Yes 

No 

High 

Yes 

Yes 

E 

Yes 

No 

No 

Low 

Yes 

Yes 

F 

No 

Yes 

No 

Low 

Yes 

Yes 

G 

No 

No 

No 

Low 

Yes 

Yes 

H 

Yes 

No 

No 

Low 

Yes 

Yes 

I 

No 

Yes 

No 

Low 

Yes 

Yes 

J 

Yes 

Yes 

No 

Low 

Yes 

Yes 

Figure  4-25.  Message  Category  Table 
4 . 5 . 3 . 2  Authority  Table 

Authority  is  defined  as  the  fact  that  a  given  destination 
is  able  to  receive  a  given  message  type  from  a  given  source.  In 
order  for  a  message  to  be  authorized,  the  message  type,  message 
source,  and  message  destination  values  given  in  the  message 
header  must  match  with  a  legal  combination  given  in  the 
authority  table. 

The  authority  table  is  accessed  where  the  Authority  Check 
Table  (Section  4.5.3.15)  indicates  that  an  authority  check  is 
reguired  on  the  given  message.  The  table  is  indexed  by  the 
Message  Source  although  all  three  values  (Source,  Type,  and 
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Destination)  must  exist  in  the  same  unique  tuple  in  the  table. 


The  fields  of  the  Authority  Table  are  briefly  described 


below . 

Field  Name 

Field  ID 

Field 

Size 

Field  Description 

Authorized 
to  Receive 

AUT-ATOREC 

X(10) 

Identifies  one  instance  of  a 
legal  destination  that  is 
allowed  to  receive  a  given 
message  type  from  a  given 
source.  The  value  in  this 
field  will  be  replicated  for 
each  tuple  in  which  the 
given  destination  is 
involved . 

Message  Type 

AUT-MSGTYP 

X(2) 

Identifies  one  instance  of  a 
given  message  type.  The 
value  in  this  field  will  be 
replicated  for  each  tuple  in 
which  the  given  message  type 
is  involved. 

Authorized 
to  Send 

AUT-ATOSND 

X(10) 

Identifies  one  instance  of  a 
send  legal  source  that  is 

allowed  to  send  a  given 
message  type.  The  value  in 
this  field  will  be  re¬ 
plicated  for  each  tuple  in 
which  the  given  source  is 
involved . 

4. 5. 3, 3  Application  Process  Information  Table 

This  table  contains  data  relative  to  any  given  Application 
Process.  This  information  is  always  available  for  routing 
purposes . 

For  this  purpose,  the  table  provides  the  name  of  the  AP 
Cluster  that  a  given  destination  AP  resides  on.  (The  physical 
location  of  any  AP  is  deliberately  invisible  to  any  other  AP  in 
order  to  provide  maximum  flexibility  in  the  assignment  of  AP ' s 
to  AP  Clusters) .  The  destination  AP  name  from  the  message 
header  must  be  mapped  to  it's  AP  Cluster  via  a  table  lookup. 
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The  destination  AP's  AP  Cluster  is  added  to  the  header  when  it 
is  found  in  the  table. 

When  the  message  is  routed,  the  MPU  checks  the  destination 
AP  Cluster  field.  As  each  MPU  knows  who  it  is,  the 
determination  can  easily  be  made  as  to  whether  the  message  is  to 
be  sent  on  or  off  AP  Cluster.  If  the  destination  is  off-AP 
Cluster,  a  lookup  is  made  in  the  AP  Cluster  status  table 
(Section  7)  to  determine  the  host  the  AP  Cluster  is  currently 
residing  on.  Again,  the  MPU  can  recognize  it's  own  host  and  can 
therefore  determine  whether  the  destination  is  on  or  off  host. 
Where  the  destination  is  off-host,  the  message  is  routed  to  the 
destination  host's  COMM  AP  Cluster.  Where  the  message 
destination  is  on-host,  the  message  is  routed  directly  to  the 
destination  AP  Cluster. 

The  format  and  identified  values  of  the  AP  Information 
Table  are  shown  in  Figure  4-26.  Each  field  is  described  below. 


Field 

Field  Name 

Field  ID 

Size 

AP  Name 

API-APNAME 

X(10) 

AP  Cluster 

API-APCNME 

X(3) 

Name 


Queue  Server  API-QSTYPE  X 
fyfie 


Field  Description 


This  field  contains  the  name 
of  a  callable  entity  within 
the  IISS.  It  is  the  key 
field  of  the  table  and  is 
accessed  by  matching  the  AP 
name  contained  in  the 
destination  field  of  the 
message  header. 

This  field  contains  the  name 
of  the  AP  Cluster  upon  which 
the  given  AP  name  resides. 
The  value  in  this  field  may 
serve  as  a  key  value  should 
the  need  arise  to  access  the 
AP  Cluster  status  table. 

This  field  identifies  the 
type  of  chaining  support 
required  by  the  AP.  This 
support  may  be  child 
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Field  Name  Field  ID  Size  Field  Description 


chaining,  message  chaining, 
or  no  chaining. 


4. 5. 3. 4  Application  Process  Status  Table 

This  table  contains  dynamic  data  associated  with  an  AP  that 
has  been  initiated.  An  entry  is  created  when  an  AP  instance  is 
initiated  and  is  maintained  until  the  AP  instance's  tree  status 
indicates  that  the  AP  instance  and  all  associated  instances  are 
terminated  and  cleaned  up. 

The  table  further  provides  the  data  needed  to  maintain  the 
tree  of  AP's  spawned  by  the  given  AP  instance  entry.  This  tree 
is  kept  to  facilitate  the  logic  needed  to  perform  an  Abort  and 
to  cleanup  after  any  kind  of  termination. 

The  individual  fields  of  the  AP  Status  Table  are  described 


belo'w. 

Field  Name 

Field  ID 

Field 

Size 

Field  Description 

APC  Name 

APS-APCNME 

X(3) 

This  field  contains  the  name 
of  the  APC  on  which  the  AP 
resides . 

AP  Name 

APS-APNAME 

X(10) 

This  field  contains  the  AP 
name  of  the  initiated  AP. 

Instance 

APS-INSTNC 

X(2) 

This  field  contains  the 
identifier  of  the  specific 
instance  of  the  initiated 

AP. 

Original 

Source 

APS-ORGSRC 

X(15) 

This  field  contains  the  AP 
name  Instance,  and  resident 
AP  Cluster  of  the  ultimate 
originator  of  the  AP.  In 
the  case  of  a  spawned  AP, 
the  originating  source  is 
the  AP  that  sent  the 
transaction  that  "fired  off" 
the  AP  at  the  top  of  the 
tree . 
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Field  Name 

Field  ID 

Field 

Size 

Field  Description 

Immediate 

Parent 

APS-IMMPAR 

X(15) 

This  field  contains  the  AP 
name,  Instance,  and  resident 
AP  Cluster  of  the  AP  that 
sent  the  transaction  that 
"fired  off"  the  given  AP 
instance.  The  value  in  this 
field  may  match  the  value  of 
originating  source. 

Child  Table 

APS-CLDIND 

9(4) 

This  field  points  to  the 

AP's  first  Index  Entry  in 
the  Child  Table.  (The  Child 

Table  is  discussed  in 

Section  4 . 5 . 3 . 5) . 

Message  Queue 
Flag 

APS-MSGQUF 

X 

This  field  indicates  whether 
there  are  messages  waiting 
for  the  AP  in  the  message 
queue . 
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Field 

Field  Name  Field  ID  Size 


Pair  Flag  APS-PRFLAG  X 


AP  Status  APS-APSTAT  X 


Message  Serial  APS-SERNLQ  X(10) 
Last  Queued 


Guaranteed  APS-GDFLAG  X 

Del ivery 

Flag 


Number  of  APS-NOCONN  X{2) 

Connections 


Logical  APS-CHANID  X(3) 

Channel  ID 


Field  Description 


This  field  indicates  whether 
the  given  AP  instance  has 
one  or  more  outstanding 
waits.  If  the  AP  does  not 
have  any  paired  msgs 
outstanding,  the  flag  will 
be  null.  The  Message 
Pairing  Table  is  discussed 
in  Section  9. 

This  field  provides  the 
current  structure  and 
operating  status  of  the  AP 
and  its  "tree"  of  AP's 
spawned  by  the  given  AP. 

The  Serial  #  and  source  AP 
Cluster  of  the  last  message 
placed  in  the  AP  instance's 
queue.  This  information 
will  be  used  to  recover  the 
state  of  the  AP. 

This  field  indicates  whether 
the  given  AP  has  one  or  more 
guaranteed  delivery  mes¬ 
sages  outstanding.  The 
Guaranteed  Delivery  table  is 
discussed  in  Section  11. 

This  field  indicates  the 
current  number  of  sources 
that  are  currently  connected 
to  an  instance  of  a  Queue 
Server.  Where  the  given  AP 
is  not  a  Queue  Server,  this 
field  will  be  null. 

This  field  identifies  the 
logical  channel  under  which 
the  given  AP  instance  was 
initiated . 
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Field  Name 

Field  ID 

Field 

Size 

Field  Description 

Ch i Idren 

APS-CHLDRN 

X 

This  field  indicates  whether 
the  given  AP  has  any  child 
AP's  associated  with  it. 

Message  In 
Queue 

APS-NMSA 

X(4) 

Identifies  the  Number  of 
Messages  in  Queue  for  the 

AP. 

Last  Key 
Pointer 

APS-LSTKEY 

X(9) 

Pointer  to  the  last  key 
value  for  the 
given  AP  in  the  AP  Queue 
Table . 

First  Pseudo 
Instance 

APS-FPINST 

X 

This  field  points  to  the 
first  entry  in  the 

Connection  Table  for  the 
given  AP. 

Last  Pseudo 
Instance 

APS-LPINST 

X 

This  field  contains  the  last 
Pseudo  Instance  number 
assigned  to  the  AP. 

4 . 5 . 3 . 5  Child  Table 


One  instance  of  a  child  table  is  used  to  maintain  one  level 
of  the  tree  of  chained  AP's.  This  table  is  in  effect  a  linked 
list  of  AP's  spawned  by  a  common  parent.  This  parent  may  also 
be  a  child  AP  itself.  The  table  has  an  entry  for  every  instance 
of  an  AP  spawned  by  an  on-WS  AP. 

The  child  table  is  accessed  when  the  parent  is  abnormally 
terminated  (aborted)  in  order  to  abnormally  terminate  any  AP's 
that  were  spawned  by  the  parent.  As  a  child  AP  may  also  be  a 
parent  AP,  its  children  would  also  be  abnormally  terminated. 

The  table  is  also  used  to  facilitate  cleanup  on  any  termination 
(normal  or  abnormal). 

The  fields  of  the  Child  Table  are  described  below. 
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Field 

Field 

Field  Name 

ID 

Size 

Field  Description 

Child  AP 
Cluster 

CLD-APCNME 

X(3) 

This  field  contains  the  name 
of  the  AP  Cluster  that  the 
child  AP  resides  on. 

Child 

Parent 

CLD-PARNME 

X(12) 

The  Process  Name  of  the 
child  AP's  parent. 

Child  Rank 

CLD-RANK 

9(4) 

The  ranking  assigned  to  the 
child  AP  when  the  table 
entry  is  made. 

Child  AP 

Name 

CLD-APNAME 

X(10) 

This  field  contains  the  AP 
Name  of  the  spawned  AP. 

Child  Status 

CLD-CLDSTS 

X 

The  child  status  indicates 
the  operational  status  of 
the  child  AP. 

Next  Sibling 

I  ndex 

CLD-NXTSIB 

9(4) 

This  field  provides  an  index 
to  the  next  child  AP  spawned 
by  the  common  parent  AP. 

Logical 
Channel  ID 

CLD-CHANID 

X(3) 

This  field  identifies  the 
logical  channel  under  which 
the  given  Child  AP  was 
spawned . 

Reserved 

Code 

CLD-RESCDE 

X 

This  field  indicates  whether 
the  entry  is  confirmed  or 
reserved . 

[lumber 

Tries 

CLD-CTRIES 

X 

This  field  indicates  how 
long  the  entry  has 

been  reserved.  At  a  given 
point,  a  reserved  entry  will 
be  deleted. 


4 . 5 . 3 . 6  AP  Characteristics  Table 

Ihis  table  provides  the  processing  characteristics  of  a 
given  AP  in  accordance  with  it's  type.  The  table  is  used  to 
determine  hov;  to  handle  a  given  AP  on  the  occurrence  of  various 
events.  As  the  characteristics  of  an  AP  are  not  directory 
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Field  Name 

Field  ID 

Size 

AP  Name 

APT-APNAME 

X(8) 

Maximum  Number  APT-NOAMSG 
Queued 

Messages 

X(2) 

Maximum 

Instances 

APT-MAXINS 

X(2) 

Number  of 
P^^rents  per 
Instance 

APT-NOPINS 

X(2) 

Initiation 

Needs 

APT-ININDS 

X 

On  Abort 

APT-ONABT 

X 

Number  of 

Ma i Iboxes 

APT-NUMMBX 

X 

On-Shutdown 

APT-ONSTDN 

X 

On-Recovery 

APT-ONREC 

X 

Field  Description 


The  AP  Name  of  the  given  AP. 
This  field  serves  as  the  key 
to  the  table. 

The  maximum  number  of  of 
messages  allowed 
in  the  AP's  queue  at  any  one 
time . 

This  field  defines  the 
maximum  number  of  instances 
of  the  given  AP  that  can  be 
awake  at  any  one  time. 

The  maximum  number  of 
parents  allowed  to  one 
instance  of  the  AP  at  any 
one  time 

This  field  identifies 
whether  the  AP 
requires  a  specific 
initiation  message  or  can  be 
started  by  any  kind  of 
message . 

This  field  indicates  how  the 
given  AP  is  to  be  handled 
when  an  Abort  message 
arrives  for  it. 

This  field  indicates  the 
number  of  mailboxes  an  AP 
will  support. 

This  field  indicates  whether 
the  given  AP  has  the 
internal  logic  to  handle 
shutdown . 

This  field  indicates  whether 
the  given  AP  has  the 
internal  logic  to  handle 
recovery . 
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Field  Name 

Field  ID 

Field 

Size 

Field  Description 

On-Child 

Normal 

Termination 

APT-ONCLDT 

X 

This  field  indicates  how  the 
given  AP  is  to  be  treated 
upon  the  normal  termination 
of  a  child  AP. 

On-Child 

Abnormal 

Termination 

APT-ONCLDA 

X 

This  field  indicates  how  the 
given  AP  Abnormal  is  to  be 
treated  upon  the  Abnormal 
Termination  of  a  child  AP. 

On-Child 

Shutdown 

APT-ONCLDS 

X 

This  field  indicates  how  the 
given  AP  is  to  be  treated 
upon  the  shutdown  of  a  child 
AP. 

Timeout 

Handling 

APT-TMOHDL 

X 

This  field  contains  a  code 
which  represents  how  the 
given  AP  is  to  be  handled  in 
the  even  of  a  timeout 
expiration . 

AP  Priority 

APT-APPRTY 

X 

This  field  provides  the 
priority  level  of  the  given 
AP. 

specific,  the  directory  prefix  is  not  used  in  this  table. 

The  fields  of  the  AP  Characteristics  Table  are  briefly 
described  below. 

4 . 5 . 3 . 7  AP  Cluster  Status  Table 

This  table  serves  to  identify  both  the  location  of  a  AP 
Cluster  within  the  IISS  and  its  current  operating  status. 

The  table  is  accessed  primarily  for  routing  purposes  in 
order  to  determine  if  the  destination  of  a  given  message  is  on 
or  off  host.  The  table  may  also  be  used  to  check  the  status  of 
a  destination  AP  Cluster  prior  to  sending  a  message. 

Each  field  of  the  AP  Cluster  Status  Table  is  defined  below. 
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Field  Name 

Field 

ID 

Field 

Size 

Field  Description 

AP  Cluster 
Name 

APC-APCNME 

X(3) 

This  field  is  the  key  to  the 
table.  It  identifies  an 
instance  of  a  AP  Cluster  on 
the  IISS. 

AP  Cluster 
Status 

APC-APCSTS 

X 

This  field  identifies  the 
current  operational  status 
of  the  given  AP  Cluster. 

AP  Cluster 
Logical 

Host 

APC-HSTNAM 

X{3) 

This  field  identifies  the 
logical  host  machine  within 
the  IISS  that  the  given 

AP  Cluster  resides  on. 

4. 5. 3. 8  Host  Status  Table 

This  table  serves  to  provide  the  current  operational  status 
of  a  host  machine  on  the  IISS.  It  is  called  out  as  a  separate 
table  in  order  to  provide  the  flexibility  of  adding  more  host 
specific  data  in  the  future. 

The  fields  of  the  Host  Status  Table  are  described  below. 


Field  Name 

Field 

ID 

Field 

Size 

Field  Description 

Logical 

Host  Name 

HST-HSTNAM 

X(3) 

This  field  is  the  key  to  the 
table.  It  identifies  an 
instance  of  a  logical  host 
machine  on  the  IISS. 

Host  Status 

HST-HSTSTS 

X 

This  field  identifies  the 
current  operational  status 
of  the  given  physical  host. 

Physical 

Host  Name 

HST-PHYHST 

X(3) 

This  field  maps  the  given 
logical  host  name  to  it's 
physical  host  name. 
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4. 5. 3. 9  Message  Pairing  Table 

The  message  pairing  table  serves  to  track  a  given  dialog 
between  APs  on  the  IISS  system.  Messages  conforming  to 
categories  requiring  pairing  services  (category  B,  D,  F,  and  J) 
v;ill  be  tracked  via  this  table. 

When  a  message  conforming  to  Category  B,  D,  or  J  is 
generated  on  a  AP  Cluster,  an  entry  will  be  made  in  the  table 
for  that  AP  Cluster.  A  timeout  will  be  set  on  the  pair,  its 
duration  to  be  either  user  defined  or  a  system  wide  default 
value.  Should  a  message  conforming  to  Category  F  come  into  the 
AP  Cluster  before  the  timeout  period  expires,  it  will  be  matched 
to  an  existing  entry  in  the  table  based  on  the  original  source 
and  channel  ID  fields  in  the  two  messages.  When  a  match  is 
made,  it  will  constitute  a  post  thereby  canceling  the  wait,  the 
timeout,  and  the  entry  in  the  table.  Should  the  timeout  expire 
before  a  post  is  set,  the  wait  will  be  canceled  and  should  the 
Category  F  message  arrive  after  the  fact,  it  will  be  rejected. 

The  overall  purpose  of  this  table  is  to  provide  the  status 
of  paired  messages  to  the  originating  source  of  the  request  upon 
the  occurrence  of  three  significant  events;  the  setting  of  a 
post;  the  expiration  of  the  timeout;  or  upon  a  paired  message 
status  request  from  the  NTM  system  services. 

The  -ds  of  the  Message  Pairing  Table  are  described 


below . 

Fielu  Name 

Field 

ID 

Field 

Size 

Field  Description 

f  aired 
Message  APC 

MPR-APCNME 

Name 

X(3) 

Identifies  the  source  APC  of 
the  paired  message. 

Original 
Source  AP 

MPR-MSGSRC 

X(15) 

This  field  contains  the 
source  of  the  "request"  end 
of  the  message  pair. 

Timeout 

Time 

MPR-TMOUTM 

X(23) 

This  field  contains  the 
system  clock  time  when  the 
timeout  on  the  given  message 
expires . 

Logical 
Channel  ID 

MPR-CHANID 

X(3) 

Identifies  the  logical 
channel  under  which  the 

paired  message  was  sent. 
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4.5.3.10  Log-On  Table 

The  Log-on  Table  will  maintain  information  regarding  the 
human  users  currently  logged  on  to  the  IISS.  The  data  will  be 
supplied  to  the  monitor  AP  by  the  User  Interface  upon  successful 
Log-on.  The  NTM  will  have  no  awareness  of  an  unsuccessful 
logon . 


The  fields  of  the  Logon  Table  are  described  below. 


Field  Name 

Field 

ID 

Field 

Size 

Field  Description 

UI ( AP) Name 

LOG-APNAME 

X(10) 

This  field  contains  the  AP 

Name  of  the  AP  Cluster  name 
of  the  UI  where  the  given 
user  is  logged  on. 

APC  Name 

LOG-APCNME 

X(3) 

Identifies  the  AP  Cluster 
that  the  given  UI  AP  resides 
on . 

Terminal  ID 

LOG-TERMID 

X(2) 

This  field  identifies  the 
terminal  where  the  given 
user  is  logged  on.  This  is 
the  instance  of  the  UI(AP) 

Name . 

User  Name 

LOG-USRNAM 

X(8) 

This  field  contains  the  User 

Name  of  the  user  logged  on 
at  the  given  AP  instance. 

Role  Name 

LOG-ROLENM 

X(10) 

This  field  identifies  the 
role  under  which  the  given 
user  is  logged  on. 

Session 

Start  Time 

LOG-STRTME 

X(23) 

This  field  contains  the 
system  clock  time  when  the 
given  user's  logon  request 
was  accepted. 

Channel 

Range  Start 

LOG-CHANST 

X(3) 

The  lowest  Logical  Channel 

ID  in  the  range  of  ID's 
allocated  to  the  user  at 
logon . 
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Field 

Field 

Field  Name 

ID 

Size 

Field  Description 

Channel 

Range  End 

LOG-CHANED 

X(3) 

The  highest  Logical  Channel 
ID  in  the  range  of  ID's 

allocated  to  the  user  at 
logon . 


4.5.3.11  Guaranteed  Delivery  Table 

This  table  is  used  to  record  all  guaranteed  delivery 
messages  that  originate  on  a  given  AP  Cluster.  The  table  is 
used  to  provide  the  age  of  a  message  to  ensure  that  it  does  not 
remain  on  the  system  forever. 

The  fields  of  the  Guaranteed  Delivery  Table  are  described 
below . 


Field  Name 

Field  ID 

Field 

Size 

Message 

Source 

GRD-MSGSRC 

X(15) 

Message 

Serial 

Number 

GRD-MSGSN 

X(7) 

Time  Stamp 

GRD-TSTAMP 

X(23) 

When  Accepted 


Message  GRD-MSGDST  X(15) 

Destination 


Field  Description 


This  field  contains  the  AP 
Name,  instance  identifier 
and  work-station  of  the  AP 
that  sent  the  guaranteed 
delivery  message. 

This  field  contains  the 
serial  number  that  was 
assigned  to  the  message  by 
the  MPu. 

This  field  contains  the  time 
when  the  given  guaranteed 
delivery  message  was 
accepted  by  the  source  MPU 
as  a  valid  IISS  message. 

This  time  provides  the  base 
for  determining  the  age  of 
the  message. 

This  field  contains  the  AP 
Name  and  AP  Cluster  of  the 
destination  AP  as  specified 
in  the  header  of  the 
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Field  Name 

Field  ID 

Field 

Size 

Field  Description 

guaranteed  delivery  message. 

Pointer 

Message 

to 

File 

GRD-MFNPTR 

X(6) 

This  field  points  to  the 
file  in  non-volatile  memory 
where  the  given  guaranteed 
delivery  message  has  been 
journalized. 
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4.5.3.12  AP  Operating  Information  Table 

This  table  provides  the  current  operational  information 
about  a  generic  AP  (as  opposed  to  a  specific  instance  of  it) . 

The  fields  of  the  AP  Operating  Information  Table  are 
defined  below. 


Field  Name 

Field  ID 

Size 

Field  Description 

APC  Name 

APO-APCNME 

X(3) 

The  name  of  the  APC  that  the 
active  AP  resides  on. 

AP  Name 

APO-APNAME 

X(8) 

This  field  in  combination 
with  the  APC  name  is  the  key 
to  the  table. 

Instances 

Currently 

Running 

APO-NUMINS 

X(2) 

This  field  provides  the 
number  of  instances  of  the 
given  AP  that  are  currently 
in  operation. 

Last  Insta 

Number 

Assigned 

nee  APO-LSTINS 

9(4) 

This  field  provides  the  last 
instance  number  assigned  to 
an  instance  of  the  given  AP. 

Number  of 
Messages 

APO-NUMMSG 

X(2) 

This  field  indicates  the 
number  of  messages  in  the 
message  queue  that  are 
waiting  for  the  given  AP. 

4.5.3.13 

I'm  A1 ive  Table 

This 

table  is  used  to 

track 

AP's  that  have  been  initiated 

but  are  not  yet  running.  As  each  entry  will  be  maintained  for  a 
limited  amount  of  time  (?  of  tries)  it  also  insures  that  an 
initiation  problem  is  detected. 


The  fields  are  defined  below. 


Field  Name 

Field  ID 

Field 

Size 

Field  Description 

APC  Name 

lAT-APCNME 

X(3) 

The  APC  of  the  AP  being 

initiated . 
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Field 

Field  Name  Field  ID  Size 


AP  Name  lAT-APNAME  X(10) 


Instance  lAT-INSTNC  X(2) 


ACK  to  Source  lAT-MPUACK  X 
MPU 


Data  Code  lAT-DATACD  X 


Number  of  lAT-NTRIES  X 

Tries 


4.5.3.14  Link  Status  Table 

The  Link  Status  Table  provides  the  current  operational 
status  of  the  link  between  two  given  physical  host  machines. 

The  fields  of  the  Link  Status  Table  are  defined  below. 


Field 

Name 

Field  ID 

Field 

Size 

Field  Description 

Link 

ID 

LST-LINKID 

X(2) 

Identifies  a  specific  link 
between  two  host  machines  on 
the  IISS. 

Link 

Status 

LST-LKSTAT 

X 

The  current  status  of  the 
given  link. 

Field  Description 


The  name  of  the  AP  being 
initiated . 

The  instance  ID  assigned  to 
the  given  AP  being 
initiated . 

Identifies  whether  the 
message  causing  the 
initiation  conforms  to 
Category  E  thereby  requiring 
an  ACK  to  be  sent  to  the 
source  MPU  upon  AP 
initiation. 

Indicates  whether  there  is 
data  waiting  for  the  given 
AP. 

Tracks  the  number  of  times 
the  entry  has  been  checked 
against  the  AP  Status  Table. 
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4.9.3.15  Authority  Check  Table 

This  table  provides  an  authority  precheck  for  messages 
conforming  to  categories  requiring  authorization.  This  is  due  to 
the  situation  where  the  message  implies  authorization  but  the 
destination  AP  has  waived  the  requirement.  This  allows  the  AP 
developer  the  right  to  either  restrict  access  to  the  AP  (on 
those  messages  requiring  authorization)  or  to  open  the  AP  to  any 
and  all  sources.  Where  access  is  restricted,  the  AP  developer 
v;ill  inform  the  COM  Administrator  as  to  the  sources  allowed 
access  and  the  message  types  accepted.  This  information  will  be 
contained  in  the  authority  table. 


The  Authority  Check  Table  will  be  accessed  by  the  MPU  on 
all  messages  requiring  authorization.  Where  the  destination 
access  is  open,  the  MPU  will  continue  message  management 
processing.  Where  the  destination  access  is  restricted,  the  MPU 
v.ill  proceed  to  check  the  message  against  the  Authority  Table  as 
described  in  Section  4. 5. 3. 2.  At  present,  the  authority  check 
is  not  concerned  with  the  directory  the  AP  is  in. 


The  Authority  Check  Table  fields  are  described  below. 


Field  Name 

Field  ID 

Field 

Size 

( Destination) 

ACT-APNAME 

X(8) 

AP  Name 

Access  Flag 

ACT-ACCFLG 

X 

Field  Description 


The  key  field  in  the  table. 
The  Destination  AP  Name  from 
the  header  is  matched  to  an 
entry  in  this  field. 

Identifies  whether  the 
access  to  the  destination  AP 
(on  messages  requiring 
authorization)  is  restricted 
or  open. 


4.5.3.16  Directory  Table 

This  table  provides  the  link  between  a  directory  prefix  and 
the  directory  name  to  which  it  refers.  The  use  of  the  directory 
prefix  allov/s  an  AP's  executable  module  to  be  located  in  a 
directory  other  than  the  directory  in  which  the  IISS  is  run. 

The  directory  prefix  is  used  in  all  AP  Interface  service 
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calls  as  a  given  AP  may  exist  as  different  versions  in  different 
directories  (i.e.,  production  version  vs.  test  version).  AP ' s 
having  the  same  base  (5  character)  name  must  adhere  to  a  common 
set  of  characteristics  regardless  of  the  number  of  versions  in 
existence . 

The  individual  fields  of  the  directory  table  are  defined 
below . 


Field  Name 

Field  ID 

Field 

Size 

Field  Description 

Directory 

Pre  fix 

DIR-PREFIX 

X(2) 

The  identifier  assigned  to  a 
given  directory.  This  ID  is 
used  as  part  of  the  AP's 
name  when  the  AP's  directory 
must  be  known. 

Directory 

Name 

DIR-DIRNME 

X  (20) 

The  name  of  the  directory 
identified  by  the  prefix. 
This  field  includes  the 
brackets  and  period. 

Directory 

Length 

DIR-NMELEN 

X(2) 

The  length  in  bytes  of  the 
directory  name  including  the 
period  but  excluding  the 
brackets . 

4.5.3.17  Connection  Table 

The  NTM  supports  AP ' s  known  as  Queue  servers.  Within  the 
type  queue  server  are  the  sub-types  of  multiple-parent  or 
single-source.  As  these  AP's  may  serve  a  number  of  source  AP's 
during  a  single  run,  they  cannot  be  tracked  by  the  current  NTM 
child  chaining  mechanism.  As  a  result,  the  genealogy  of  a  given 
source  AP  will  be  broken  when  the  path  encounters  a  queue 
server.  In  order  to  maintain  this  genealogy,  the  NTM  will, 
given  the  characteristic  of  an  AP  requiring  Message  chain 
support,  track  (chain)  a  message  at  the  point  at  which  it 
encounters  a  queue  server. 

In  order  to  handle  the  tracking  of  messages  at  a  queue 
server  AP,  an  entry  will  be  made  in  that  AP's  connection  table. 
This  entry  establishes  a  "Pseudo"  Instance  or  connection  which 
is  considered  to  be  a  separate  instance  of  the  AP.  The 
connection  table  entry  contains  values  pertinent  to  the 
particular  connection  as  opposed  to  the  AP  instance  itself. 
I'horefore,  in  one  AP  instance  there  may  be  two  connections,  one 
of  which  has  child  AP's  and  one  which  may  not.  In  this  manner, 
the  genealogy  may  be  traced  beyond  a  queue  server. 

As  for  the  child  table,  the  connection  table  is  maintained 
as  a  linked  list  with  a  pointer  from  the  AP's  table  to  the  first 
entry  for  the  AP. 
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The  individual  fields  of  the  connection  Table  are  described 
belov; . 


Field 

Field  Name  Field  ID  Size 


Pseudo  CON-PINST  X 

Instance 

Client  Name  CON-CLNAME  X(10) 

Client  Pseudo  CON-CLPINS  X 

Instance 

Child  Rank  CON-CLDRNK  9(4) 


Pair  Flag  CON-PRFLG  X 


Children  CON-CHILD  X 


Field  Description 


Identifies  the  Pseudo 
instance  assigned  to  the 
given  connection.  This 
value  may  also  be  carried  in 
the  APS  table  to  provide  a 
pointer  into  the  connection 
table . 

The  name  of  the  source  AP  of 
the  given  connection. 

The  pseudo  instance  of  the 
source  AP  is  included  if  the 
source  AP  is  also  a  queue 
server.  If  the  source  is 
not  a  queue  server  this 
field  will  be  blank. 

As  in  the  APs  table,  this 
field  points  to  the  first 
child  entry  associated  with 
the  given  connection. 

Indicates  whether  the  given 
connection  has  outstanding 
paired  messages. 

Indicates  whether  the  given 
connection  has  any  child 
AP's  associated  with  it. 
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Field  Name 

Field  ID 

Field 

Size 

Field  Description 

Connection 

Channel 

CON-CONCHN 

X(3) 

The  channel  ID  from  the 
message  that  established 
given  connection. 

the 

Next 

Connection 

CON-NXTCON 

X 

Pointer  to  the  next  Pseudo 
instance  associated  with  the 
Queue  Server  AP.  The  end  of 

the  chain  is  indicated  where 
the  last  pseudo  instance 
points  to  itself. 

4 . 6  Adaptation  Requirements 

The  NTM  must  be  compiled,  linked  and  installed  on  each  host 
in  the  IISS  Test  Bed.  The  Test  Bed  consists  of  a  VAX-11/780  (VMS 
operating  system)  and  IBM  4381  (MUS/XA-750  operating  system) . 

NTM  modules  that  are  machine  specific  must  be  included  in 
the  IISS  system  built  on  each  host.  As  a  goal  it  would  be 
desirable  to  have  the  host  specific  statements  conditionally 
compiled  or  assembled  based  on  host  type  input.  Adding  a  new 
host  type  requires  writing  these  machine  specific  modules  for 
that  host. 

4 . 7  Government  Furnished  Property  List 

This  paragraph  is  not  applicable  to  the  NTM  CPCI . 
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SECTION  5 

QUALITY  ASSURANCE  PROVISIONS 


5.1  Introduction  and  Definition 


The  NTM  Quality  Assurance  will  be  coordinated  with  the  IISS 
integration  contractor,  Boeing  Military  Airplane  Company,  to 
ensure  that  it  supports  the  QA  needs  for  the  IISS. 

The  philosophy  of  Quality  Assurance  involves  more  than  simply 
testing  code.  QA  begins  with  Reguirements  Definition  and 
continues  throughout  the  System  life  Cycle.  BCS  supports  this 
concept  of  QA  via  constant  peer  review.  This  review  is 
facilitated  through  the  device  of  the  IDEE  kit  cycle.  The  kit 
cycle  allows  any  member  of  the  NTM  team  to  circulate  their  work 
for  the  purpose  of  soliciting  comments.  These  comments  provide  to 
the  kit  author  insights  as  to  holes,  inconsistencies,  potential 
bugs,  and  sometimes,  kudos  for  work  well  done.  It  provides  a  view 
of  the  forest  when  the  author  is  sometimes  so  mired  in  details 
that  barely  the  trees  are  visible. 

The  NTM  project  has  made  the  IDEE  kit  cycle  an  integral  part 
of  its  Standard  Operating  Procedure.  This  has  continued  with  the 
review  of  structure  charts,  module  descriptions,  PDL,  and  code. 

Testing  of  NTM  code  will  occur  at  three  levels.  Eirst,  unit 
level  tests  will  be  performed  by  BCS  for  each  major  portion  of 
code  to  detect  coding  errors  and  errors  resulting  from  the 
interaction  of  modules.  Unit  level  testing  will  take  place  for 
each  release  of  the  NTM.  Second,  BCS  will  support  BMAC  in  IISS 
Test  Bed  Integration  Preliminary  Qualification  Testing  (PQT)  for 
each  NTM  release.  Third,  BCS  will  support  BMAC  in  IISS  Eormal 
Qualification  Testing  (EQT)  following  integration  testing  of  the 
last  release  of  the  NTM. 
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5 . 2  Computer  Programming  Test  and  Evaluation 
5.2.1  Test  Approach 

Testing  or  code  is  driven  by  scenarios  written  to  reflect  the 
requirements  stated  in  Section  4  of  this  document.  Figure  5-1 
provides  a  matrix  of  requirements  to  test  cases.  The  specific 
tests  are  described  in  detail  in  Section  5.2.4.  The 
implementation  of  these  scenarios  include  small  integrated  test 
AP's  having  the  characteristics  noted  in  the  scenarios.  The 
scenarios  include  (but  are  not  limited  to) : 

o  Startup  Host 

o  Startup  IISS 

o  Accept  Logon  message  from  UI 

o  Initiate  an  AP  using  CALL  "ISEND" 

o  Initiate  an  AP  using  CALL  "NSEND" 

o  Maintain  the  status  of  an  AP  from  initiation 

through  normal  termination 
o  Abort  an  AP  from  an  Operator  Command 

o  Accept  Logoff  message  from  UI 

o  Build  NTM  tables  from  file 

o  Handle  host  to  host  communications  between  AP's 

o  Shutdown  Host 

o  Shutdown  IISS 
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DS 

Ref. 
4. 1.2.1 


4. 1.2.2 

4. 1.2. 3 

4. 1.2.4 


NTM  DS  Requirement 

Test  Case 

Interface  to  New  AP's 
(System  Services) 

INITAL 

All  Support  Test  AP's 

ISEND 

TSPUIMPU-Choice-3 

NSEND 

TSPUIMPU-Choices-1 , 2 

RCV 

All  Test  AP's 

TRMNAT 

All  Test  AP's 

GETUSR 

TSPUIMPU-Choice-3 

CHKMSG 

TSPUIMPU-Choice-3 

GDSEND 

TSGDMMPU 

SETDLY 

Logic  Not  Implemented 

SIGERR 

TSSIGMPU 

GDACK 

TSGDRMPU 

TSTMOD 

TSSUIMPU 

APSTAT 

Logic  Not  Implemented 

HSTATS 

Logic  Not  Implemented 

WHTHST 

TSNTMMPU  Choice  8 

WHATAC 

Logic  Not  Implemented 

WKONCA 

Logic  Not  Implemented 

ACSTAT 

Logic  Not  Implemented 

SIGABT 

Logic  Not  Implemented 

PRSTAT 

Logic  Not  Implemented 

GDSTAT 

Logic  Not  Implemented 

Interface  to  Existing  AP's  TBD 


Interface  to  COMM  AP's 
(System  Services) 

INICOM  Startup  (Start  COMVH) 

Interface  to  UI 
(System  Services) 

INITEX  Run  TSPUIMPU, 

TSNTMMPU,  TSSERMPU  or 
TST12MPU 

LOGON  Run  TSPUIMPU, 
TSNTMMPU,  TSSERMPU  or 
TST12MPU  LOGOFF 
Run  TSPUIMPU, 
TSNTMMPU, 


Figure  5-1.  Requirement  to  Test  Matrix 
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DS 

Ref. 

4. 1.2.5 


4 . 1. 3 . 1 

4. 1.3.2 

4. 1.3. 2.1 

4. 1.3. 2. 2 


Figure  5 


NTM  DS  Requirement 
CHGROL 


Test  Case 

TSSERMPU  or  TST12MPU 
TSTNTMMPU-Choice-1 


Interface  to  IISS  Operator 
(Operator  Commands) 

Start  IISS 
Start  APC 
Start  Link 
Shutdown  Host 
Shutdown  APC 
Shutdown  IISS 
Cancel  IISS  Shutdown 
Abort  AP 

Display  Active  AP's 
Display  IISS  Status 
Enable  Sigerr  Messages 
Disable  Sigerr  Messages 
Select  Logging  Features 
Start  New  Log  File 


(at  Operator  Console) 
Run  Monitor 
Enter  "ST"  Command 
Enter  "SL"  Command 
Logic  Not  Implemented 
Enter  "SC"  Command 
Enter  "SD"  Command 
Enter  "CN"  Command 
Logic  Not  Implemented 
Enter  "DA"  Command 
Enter  "DS"  Command 
Enter  "SE"  Command 
Enter  "SO"  Command 
Enter  "LG"  Command 
Enter  "SN"  Command 


Message  Header  All 

Monitor  IISS 


Accept  IISS  Operator 
Commands 

Service  Commands 
Start  IISS  on  VAX 
Start  IISS  on  Non-Vax 
Hosts 
Start  APC 
Start  Link 
Shutdown  APC 
Shutdown  IISS 
Shutdown  Host 
Cancel  IISS  Shutdown 
Abort  AP 

Display  Active  AP's 
Display  IISS  Status 


Enter  Commands  at 
Operator  Console 


Run  Monitor  (VAX) 

Run  Monitor  (IBM) 

Enter  "ST"  Command 
Enter  "SL"  Command 
Enter  "SC"  Command 
Enter  "SD"  Command 
Logic  Not  Implemented 
Enter  "CN"  Command 
Logic  Not  Implemented 
Enter  "DA"  Command 
Enter  "DS"  Command 
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DS 

Ref. 

4. 1.3. 2. 3 


4. 1.3. 2. 4 


4. 1.3. 2. 5 


4. 1.3. 2. 6 


NTM  DS  Requirement 

Deliver  IISS  Status 
Messages  to  Operator 

Accept  Messages  From: 
IISS  ARC'S 
IISS  AP's 

Remote  Monitor  AP's 


Test  Case 

All  Test  AP's, 
Startup,  Execute 
Operator  Commands 

Startup  IISS 
All  test  AP's 
Logic  Not  Implemented 
on  Remote  Host 


Send  IISS  System  Commands 


and  Responses 

Operator  Abort 
Start  Link 

Cancel  Shutdown 

Start  MPU 

List  Request 
Shutdown  Link 
Shutdown  Pending 


Table  Status  Return 
Shutdown  Host 
Rebuild  Tables 

Process  Messages 


Link  Active 
Link  Fail 


Processing  Error 
APC  Terminated 


(at  Operator's 
Console) 

Logic  Not  Implemented 
Startup,  enter  "SL" 
Command 

Startup,  enter  "CN" 
Command 

Startiip,  enter  "ST" 
Command 

Enter  "DA"  Command 
Enter  "LS"  Command 
Enter  "SD"  Command 
with  one  or 
more  minutes  until 
shutdown 
Startup 

Logic  Not  Implemented 
Logic  Not  Implemented 

(Error  Message 
Displayed  at 
Operator's  Console) 
Startup,  Result  of 
"SL"  Command 
Startup,  REsult  of 
"LS" 

Command,  Shutdown 
All 

Startup,  Shutdown, 
Result  of 
"SC"  Command 


Figure  5-1.  Requirement  to  Test  Matrix  (Continued) 
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DS 

Ref. 


NTM  DS  Requirement 

Logon 

Logoff 

Table  Status  Request 
Shutdown  Host 
ARC  Alive 

Resource  Unavailable 


Test  Case 

TSPUIMPU,  TSNTMMPU, 
TSSERMPU, 

TST12MPU 

TSPUIMPU,  TSNTMMPU, 
TSSERMPU, 

TST12MP 

Startup  IISS 

Logic  Not  Implemented 

Startup  IISS,  "ST" 

Command 

Upon  Receipt  of  "RU" 
Message  from  MPU 


Figure  5-1.  Requirement  to  Test  Matrix 
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4.1.3 

(Cent 

4.1.3 

4.1.3 

4.2.1 

4.2.2 

4.2.3 

4.2.4 


DS 

Ref. 


2 . 6 
) 


2.7 


.2.8 


NTM  DS  Requirement 

AP  Interface  Error 

Tables  Rebuilt 
Timeout  Expired 


Send  IISS  Status  Message 
Global  Table  Update 
Host  Available 
Host  Active 


OFF-Host  Shutting  Down 
APC  Shutting  Down 


Receive  and  Process 
Status  Messages  from 
Remote  Monitor 

Receive  and  Interpret 
Message 


Authorize  Message 


Complete  Message  Header 
Logoff 

Perform  Special  Message 

Handling 

Paired  Messages 


Test  Case 

Upon  Receipt  of  "AI" 
Message  from  MPU 
Logic  Not  Implemented 
Upon  Receipt  of  "TE" 
Message  from  MPU 


Logic  Not  Implemented 
Logic  Not  Implemented 
Startup,  also  Upon 
Receipt  of  "LA" 
Message 

Upon  Receipt  of  "LF" 
Message 

Logic  Not  Implmented 
Directly-  function 
handled  via  APC 
Status  Table  Update 


Startup,  Execute 
Operator  Commands, 

All  Test  AP's 

Authority  Check  -  All 
Test  AP's  Authority 
Table-Table  not 
Populated 

All  Test  APs 
TSPUIMPU,  TSNTMMPU, 


TSPUIMPU-Choice-3 , 


Figure  5-1.  Requirement  to  Test  Matrix  (Continued) 
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DS 

Ref. 


4.2.5 


4.2.6 


4.2.7 


4.2.8 

4.2.9 


NTM  DS  Requirement 

GD  Messages 
Specific  Initiation 

Messages 
Log  Message 

Route  and  Send 
Message 

Interpret  Message 
Category 

Initiate  AP 

Deliver  Messages  to  AP 


Test  Case 
TSNTMMPU-Choice-4 , 
TSSERMPU-CH- d  3  and 
5,  TSri.^:'’PU-choice-3 
Logic  Not  Implemented 
TSPUIMPU-Choice-3 , 
TSNTMMPU-Choice-5 , 
TST12MPT’ -Choice-3  and 
4 

Startup,  Execute 
Operator  Commands, 

All  Test  AP's 

Startup,  Shutdown, 

All  Test  AP's, 

Execute  Operator 
Commands 

Startup,  Shutdown. 

All  Test  AP's, 

Execute  Operator 
Commands 

TSPUIMPU-Choices-1-5 , 
TSNTMMPU-Choices-2-5 

All  Test  AP's 


4.2.10 


Accept 

(System 

GETUSR 


INITAL 

TRMNAT 

ENDRCY 

NSEND 

GDSEND 

ISEND 

CHKMSG 


Requests  from  AP 

Services)  (AP's  Using  Services) 
TSAP3MPU , TSAP4MPU , 
TSAP7MPU , TSAP8MPU , 
TSAP9MPU , TSAPDMPU 
All  Test  AP's  on  APC 
TIV 

All  Test  AP's 
Logic  Not  Implemented 
All  Test  AP's 
TSGDMMPU 

TSNTMMPU , TSPUIMPU ,  TSS 
ERMPU,TST12MPU 
TSPUIMPU , TSNTMMPU , TSS 
ERMPU , TSAP8MPU , TST12M 


Figure  5-1.  Requirement  to  Test  Matrix  (Continued) 
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DS 

Ref. 


4.2.11 


4.2.12 


4.2.13 


4.2.14 


Figure  5 


NTM  DS  Requirement 


SETDLY 

GDACK 

MSGACK 

RCV 

TSTMOD 

CHGROL 

Terminate  AP 
Abort  AP 

Shutdown  AP  with  Logic 

AP  without  Logic 
Normal  Termination 


Handle  System  Commands 
Start  APC 

Shutdown  AP 


Shutdown  APC 
Display  Active  AP's 


Handle  APC  Message  Queues 
I'm  Alive  Queue 
Off-APC  Queue 
Initiation  Message  Queue 


Handle  APC  Tables 


Test  Case 

TS AP5MPU , TS AP6MPU , 

PU 

Logic  Not  Implemented 
Logic  Not  Implemented 
Logic  Not  Implemented 
All  Test  AP's 
TSSUIMPU 

TSNTMMPU-Choice-1 


Logic  Not  Implemented 
TSPUIMPU , TSNTMMPU , 
TSSERMPU 

TSAPIMPU , TSAP9MPU 
All  Test  AP's  (via 
TRMNAT) 


Upon  Receipt  of  "ST" 
Command 

Direct  Command  Not 
Implemented  (AP 
Shutdown  only  as  the 
result  of  Shutdown 
APC  or  Shutdown 
IISS  Command) 

Upon  Receipt  of  "SC" 
Command 

Upon  Receipt  of  "DA" 
Command 


TSPUIMPU-Choices-1-3 
TSPUIMPU-Choice-1 , 
TSSERMPU-Choice-2 
TSNTMMPU-choice-2 

All  Test  AP's  require 
table  handling 


-1.  Requirement  to  Test  Matrix  (Continued) 
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Each  scenario  includes  specific  input  data  (some  of  which 
will  be  intentionally  wrong) ,  the  expected  processing,  and 
expected  output.  The  results  are  verified  by  "canned"  messages 
written  into  the  test  AP's.  The  NTM  Message  Log  and  IPC  ERRPRO 
will  be  used  to  provide  data  on  internal  processing.  A  third 
verification  tool  is  the  Monitor  AP's  capability  to  display 
error  messages  to  the  IISS  Operator. 

5.2.2  Test  Plan 

The  testing  of  the  NTM  is  facilitated  by  a  primary  test 
driver,  TSPUI.  This  driver  was  designed  to  simulate  the  User 
Interface,  hence  it's  name  -  Pseudo  UI.  This  allows  user 
interaction,  error  and  status  displays,  and  testing  of  code 
specifically  designed  to  support  the  UI. 

TSPUI  gets  Logon  information  from  the  user  and  then 
presents  the  user  with  a  menu  of  choices  as  shown  in  Figure  5-2. 

$  RUN  TSPUIMPU 

ENTER  USER  NAME-MAXIMUM  OF  8  CHARACTERS. 

CROSS 

ENTER  ROLE  NAME-MAXIMUM  OF  10  CHARACTERS. 

TESTER 

(Date  and  Time  of  Logon) 

1  RUN  API 

2  RUN  AP2 

3  RUN  AP3 

4  RUN  TSPQS 

5  QUIT 

6  LOOP- 3 

7  LOOP-1 

ENTER  CHOICE  NUMBER 


Figure  5-2.  TSPUIMPU  Menu 

The  user  enters  a  choice  thereby  setting  in  motion  a  specific 
test. 

TSPUIMPU  has  grown  too  large  to  incorporate  all  the  test 
choices  needed  to  exercise  the  NTM  code.  Five  more  test  drivers 
have  been  created  using  the  TSPUIMPU  "shell"  while  offering  new 
choices.  These  AP's  are  TSNTMMPU,  TSSERMPU,  TST12MPU,  TSSUIMPU, 
TSGDMMPU,  TSABTNPU.  Their  user  menus  are  shown  in  Figures  5-3 
through  5-8. 
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Nineteen  additional  test  AP's  have  been  written  to  support 
the  choices  offered  in  the  test  drivers.  All  of  the  choices  are 
described  in  detail  in  the  next  section. 


$  RUN  TSNTMMPU 

ENTER  USER  NAME-MAXIMUM  OF  8  CHARACTERS. 
CROSS 

ENTER  ROLE  NAME -MAXIMUM  OF  10  CHARACTERS. 


TESTER 


(Date 

and  Time  of 

Logon) 

1 

CHG  ROLE 

2 

TEST  INIQ 

3 

TEST  NI 

4 

TEST  TO 

5 

BAD  INIT 

6 

FILL  MBX 

7 

WHTHST 

8 

QUIT 

ENTER 

CHOICE 

NUMBER. 

Figure 

5-3. 

TSNTMMPU  Menu 

$RUN  TSSERMPU 

ENTER  USER  NAME-MAXIMUM  OF  8  CHARACTERS. 
CROSS 

ENTER  ROLE  NAME-MAXIMUM  OF  10  CHARACTERS. 
TESTER 

(Date  and  Time  of  Logon) 

1  INV  DEST 

2  OFF  APCQ 

3  CHECK  HOT 

4  FILL  LOG 

5  STUFF  MBX 

6  HOT  MBX 

7  QUIT 
ENTER  CHOICE  NUMBER. 


Figure  5-4.  TSSERMPU  Menu 
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$  RUN  TST12MPU 

ENTER  USER  NAME-MAXIMUM  OF  8  CHARACTERS. 

CROSS 

ENTER  ROLE  NAME-MAXIMUM  OF  10  CHARACTERS. 

TESTER 

(Date  and  Time  of  Logon) 

1  NO  MAILBOX 

2  FILL  CORE 

3  PAIR  INIT 

4  LONG  INIT 

5  RUN  QUEUE 

6  QUIT 
ENTER  CHOICE  NUMBER. 

6 

THE  TEST  APPLICATION  PROCESSES  PORTION  OF  THE  DEMO 
IS  COMPLETE 


Figure  5-5.  TST12MPU  Menu 
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$RUN  TSSUIMPU 

ENTER  USER  NAME-MAXIMUM  OF  8  CHARACTERS. 
CROSS 

ENTER  ROLE  NAME-MAXIMUM  OF  10  CHARACTERS. 
TESTER 

(Date  and  Time  of  Logon) 


Figure  5-6.  TSSIG  Menu 


This  is  a  test  of  the  Sigerr  and  TSTMOD  services.  This  test 
invokes  a  test  AP  that  will  generate  a  requested  number  of 
messages.  It  will  alternate  between  regular  messages  and  error 
messages  of  different  severity  levels. 

On  Choice  1  you  should  receive  the  indicated  number  of  regular 
messages  with  error  messages  of  alternating  severity  level. 

On  Choice  2,  you  should  receive  the  indicated  number  of  regular 
messages.  No  error  messages.  Informatory  (severity:  I) 
messages  will  also  be  displayed. 

On  Choice  3,  you  should  receive  the  regular  messages  and  error 
messages  of  only  F  severity  level  and  informatory  (I)  messages. 

To  check  the  messages  that  are  being  sent  against  those 
received,  enable  the  Sigerr  messages  at  the  operator's  console 
(SE) .  With  Sigerr  enabled,  all  SE  messages  will  be  displayed  at 
the  operator's  console. 

1. 

2 . 

3 . 

4  . 


Figure  5-7.  TSSUIMPU  Menu 


Set  TESTMODE  for  all  messages  and  test 
Disable  testmode  for  no  error  messages  and 
test 

Set  testmode  for  fatal  error  only  and  test 
Quit . 
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This  is 
invokes 
request 


$Run  TSGDMMPU 

ENTER  USER  NAME-MAXIMUM  OF  8  CHARACTERS. 
CROSS 

ENTER  ROLE  NAME-MAXIMUM  OF  10  CHARACTERS. 
TESTER. 


a  test  of  the  guaranteed  delivery  service.  'T’his  test 
a  test  AP  that  will  generate  a  guaranteed  delivery 
message  for  an  AP  that  will  process  this  request. 


NOTE:  No  formal  menu  will  appear.  If  the  GDSEND 

test  works, the  test  screen  will  display. 

GD  MESSAGE  IS  ON  ITS  WAY 

GD  AP  HAS  COMPLETED 

The  test  application  processes  portion  of  the  Demo 
is  complete 


Figure  5-8.  TSGDMMPU  Menu. 
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$  RUN  TSABTMPU 
TSABTMPU:  MAIN  MENU 


1.  =  INFORMATION  ON  THE  SIBABT  TES'^  SUITE 

2.  =  EXECUTE  COMPLETE  SIGABT  ACCEPTANCE  TEST 

3.  =  GO  TO  SPECIAL  TEST  MENU 

4.  =  PERFORM  CONFIGURATION  CHECK  TEST 

5.  =  QUIT 
ENTER  CHOICE: 


This  is  a  test  of  the  SIBABT  function  of  the  NTM.  Choice  2  will 
execute  the  entire  suite  of  SIGABT  tests.  Selection  option  3 
will  display  a  menu  from  which  individual  test  may  be  run.  The 
option  2  menu  is  as  follows: 

TSABTMPU:  SPECIAL  TEST  MENU 


1  =  TEST  SOFT  ABORT 

2  =  TEST  HARD  ABORT 

3  =  ABORT  ONE  OF  SEVERAL  CONNECTIONS 

4  =  CHILD  RUNDOWN  ON  ABORT  TEST 

5  =  RETURN  TO  MAIN  MENU 
ENTER  CHOICE: 

Selection  Option  4  from  the  main  menu  produces  a  report  of  the 
test  configuration  showing  which  host  each  of  the  application 
programs  in  this  test  suite  is  on  and  reporting  any  problems  in 
API  and  APC  tables. 


Figure  5-8a.  TSABTMPU 
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5.2.3  Test  Descriptions 

The  tests  needed  to  exercise  the  NTM  code  are  defined  below 
as  to  name,  configuration,  description,  purpose,  and  AP 
Interface  services  tested.  The  overall  test  configuration  is 
shown  in  Figure  5-9. 


TSSEXMPU 
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Test  Name:  Operator  Commands 
Test  Configuration: 


Test  Description: 

While  there  are  no  active  AP’s,  the  operator  enters  each 
available  command  in  random  order.  After  commands 
altering  the  system  state  (Shutdown  APC  and  Shutdown  Link) 
the  display  system  status  command  is  used  to  verify  the 
results . 

Test  Purpose: 

1.  Monitor  AP  System  Command  Processing. 

2.  MPU  System  Command  processing. 
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Test  Configuration: 


TSPUIMPU 
(UIV  APC) 


Logon  Motagc 


Logon  Rtsponto 


NTMONITV 
(MRV  APC) 


Logon  Ditplay 


Opora  tor's 
Con  sola 


Test  Description: 

TSPUIMPU  connects  to  the  NTM  from  an  external  terminal.  A 
logon  message  is  sent  to  Monitor  AP. 

Test  Purpose: 


1.  Connect  to  NTM  from  external  terminal. 

2.  Send  a  message  from  an  AP  to  the  Monitor  AP. 

3.  Display  Logon  data  to  the  operator. 

4.  Logon  table. 

Services  Tested: 

INITEX 

LOGON 

System  Dependent  Code  Tested: 

SYS$ASCTIM 
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Test  Name:  TSPUIMPU  -  Choice  1  or  2  ("Run  API"  and  "Run 
AP2 " ) /TSPUIMPU-Choice-8 (loop-1) 

Test  Configuration: 


Test  Description: 

TSPUIMPU  starts  TSAP1MPU/TSAP2MPU  with  a  category  "B" 
message  (reply  required) .  TSAP1MPU/TSAP2MPU  respond  and 
engage  in  a  limited  dialog  with  TSPUIMPU.  At  the  end  of 
the  dialog  TSAP1MPU/TSAP2MPU  terminate  normally  while 
TSPUIMPU  waits  for  the  message  telling  it  that  a  child  AP 
has  ended  execution.  Choice-8  will  irun  this  test  in  a 
continuous  loop  50  times. 

Test  Purpose: 

1.  Child  AP  Initiation. 

2.  AP  to  AP  communication. 

3.  Send  message  off-cluster. 

4.  Receive  message  from  off-cluster. 

5.  Send  Child  Termination  Message  to  Parent  AP. 

6.  Cleanup  upon  Child  Termination. 

7.  Send  Unsolicited  Initiation  Accept. 

8.  Log  Message. 

9.  Message  Pair  Table. 

10.  Choice-8  tests  the  NTM's  endurance  and  table 
handling. 

Services  Tested: 

INITAL 

NSEND 

RCV 

TRMNAT 
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Test  Name:  Late  Response  on  Message  Pair  (using  TSPUIMPU 
Choice-1) 

Test  Configuration: 


(te  T1V  MPU) 


Test  Description: 

Before  the  user  at  TSPUIMPU  enters  a  choice,  TIV  APC  is 
shutdown.  Then  the  user  enters  Choice  1.  TIV  APC  is  then 
started  but,  in  the  interim  the  message  to  TSAPIMPU  has 
timed  out.  TSAPIMPU  will  respond  anyway.  When  the 
response  gets  back  to  UIV  it  will  not  be  delivered  due  to 
the  timeout. 

Test  Purpose: 

1.  Message  Pair  Timeout. 

2.  Late  response  to  a  timed  out  message. 
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Test  Name:  TSPUIMPU  -  Choice  3  ("Run  AP3'')/TSPUIKMPU-Choice-7 
(Loop- 3) 


Test  Configuration: 


Test  Description: 

TSPUIMPU  starts  TSAP3MPU  with  a  specific  initiation 
message.  TSAP3MPU  then  starts  TSAP4MPU.  TSAP3MPU  and 
TSAP4MPU  engage  in  a  limited  dialog.  At  the  end  of  the 
dialog  TSAP3MPU  terminates  while  TSAP4MPU  continues 
execution.  TSAP4MPU  finds  the  original  source  AP 
(TSPUIMPU)  and  sends  it  a  final  status  message.  TSAP4MPU 
then  terminates. 

Choice-7  will  run  this  test  in  a  continuous  loop  50  times. 
Test  Purpose: 


1.  Send  message  on-cluster. 

2.  Immediate  Parent  dies  before  child. 

3.  Initiate  AP  on  category  "H”  message. 

4.  Cleanup  when  all  child  (and  grandchild)  AP's  are 

terminated. 

5.  Grandchild  AP  sends  message  to  Original  Source  AP. 

6.  In  choice-7  tests  endurance  of  the  NTM  and  Instance 

rollover  after  the  99th  instance. 
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Services  Tested: 

ISEND 

GETUSR 

CHKMSG  (Cold  Mailbox  -  Any  Match) 
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Test  Name:  TSPUIMPU  -  Choice  4  ("Run  TSPQS”) 

Test  Configuration: 


Attign  merit 
T«DI« 


Test  Description: 

TSPUIMPU  starts  TSPQSMPU  (Pseudo  Queue-Server)  and 
displays  a  menu  of  Machinist  Numbers  and  Machinist  Names 
to  the  user.  The  user  enters  one  number  at  a  time  to  get 
the  group  assignment  of  the  machinist.  The  Queue-Server 
will  check  the  Assignment  Table  and  return  the  correct 
group  assignment  number.  This  test  will  run  until  the 
user  enters  “gs”  to  specifically  end  the  session. 

Test  Purpose: 

1.  Queue  Server  Logic 
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Test  Name:  Shutdown  Pending/Shutdown  IISS  (using  TSPUIMPU  - 
Choice  4) 

Test  Configuration: 


SUr'tup  MciMg* 


Test  Description: 

While  running  Choice  4,  the  operator  enters  the  shutdown 
pending  command.  At  the  end  of  the  allotted  time,  the 
shutdown  IISS  command  will  be  sent  to  the  active  APC's. 
The  user  on  TSPUIMPU  will  have  sufficient  time  to  end  the 
session  and  exit  gracefully.  Or,  the  user  can  continue 
the  session  until  TSPUIMPU  shuts  itself  down. 

Test  Purpose: 


1.  Monitor  and  MPU  Shutdown  Pending  Logic. 

2.  Shutdown  with  Active  AP's. 

3.  Soft  shutdown  of  AP  having  shutdown  logic. 

4.  Monitor  and  MPU  shutdown  IISS  logic 

Services  Tested: 

CHKMSG  (Hot  Mailbox  -  NTM  Requests) 
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Test  Name:  Shutdown  Pending/Cancel  Shutdown  (using  TSPUIMPU  - 
Choice  4) 


Test  Configuration: 


Test  Description: 

The  same  as  Shutdown  Pending/Shutdown  IISS  except  that  the 
operator  enters  the  cancel  shutdown  command  before  IISS 
shutdown  begins. 

Test  Purpose: 


1.  Monitor  AP  and  MPU  cancel  shutdown  logic. 

2.  Cancel  shutdown  message  to  the  UI. 
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Test  Name;  TSPUIMPU  -  Choice  6  (Quit) 
Test  Configuration: 


TSPUIMPU 
(Uiv  APC) 


Logoff  NTMONITV 

- ^  (MRV  APC) 


Logoff 

Display 


— \  Opar 

> 


Oparator's 
Con  sola 


Test  Description: 

TSPUIMPU  informs  Monitor  AP  that  the  user  has  logged  off. 
It  then  disconnects  from  the  NTM. 

Test  Purpose: 


1.  Disconnect  from  the  NTM. 

2.  Logoff  Message  Logic. 

3.  Logon  Table. 

4.  Display  Logoff  information  to  the  Operator. 

Services  Tested; 

TRMNAT 

LOGOFF 
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Test  Name:  TSNTMMPU  -  Choice  1  (Change  Role) 
Test  Configuration: 


TSNTMMPU 

NTMONITV 
(Mttv  APC) 

Logon  MatMgo 

ChanQt  Rol«  Mtftugt 

Naa  Rel«  ^ 

(UIV  APC) 

► 

Logoff  Moiugo 

Logoff  MatMQ*  ^ 

- ^ 

Test  Description: 

The  user  logged  on  at  TSNTMMPU  is  allowed  to  change  the 
role  specified  at  Logon.  The  new  role  is  entered  and 
passed  to  the  Monitor  AP.  The  user  then  logs  off  using 
the  new  role. 

Test  Purpose: 


1.  Monitor  AP's  Change  Role  Logic. 

2.  Logon  Table  updates. 

Services  Tested: 

CHGROL 
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Test  Name:  TSNTMMPU  -  Choice  2  (Test  Initiation  Queues) 

Test  Configuration: 


TSNTMMPU 
(UIV  APC) 


First  Initiation  Mess»g* _ 

Second  Initiation  Mesfge 

AP-AP  Dialog  (Instance  01) 

< - 

^  Termination  Message 

^  AP-AP  Dialog  (Instance  03) 
Termination  Message 


>*,  TSAP»k1PU01 
(T1V  APC) 


TSAP2MPU  03 


Test  Description: 


two  specific  initiation  messages  to 
TSAP2MPU.  AS  TSAP2MPU  is  allowed  only  one  active  instance 
fc  second  initiation  message  is  queued.  When 

sta  t^d^^  instance  terminates,  the  second  instance  is 


Test  Purpose: 


i*  Initiation  Message  Queue. 

2.  AP  Characteristic  of  single  instance. 

3.  Start  second  instance. 

4.  MPU  Time  Chec)c  Logic 
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Test  Name:  TSNTMMPU  -  Choice  3  (Test  Unsuccessful  Initiation) 
Test  Configuration: 


Test  Description: 

TSNTMMPU  attempts  to  start  “DUMMYMPU''  on  a  specific 
initiation  message.  “DUMMYMPU"  is  listed  in  all  the  right 
tables  but  does  not  in  fact  exist.  Upon  the  attempt  to 
start  it,  the  MPU  will  detect  that  it  is  not  alive  and 
return  an  Unsuccessful  Initiation  Message  to  the  source 
AP. 

Test  Purpose: 


1.  Unsuccessful  Initiation. 

2.  MPU  I'm  Alive  Table  Checker. 

3.  Child  Table  Logic. 
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Test  Name;  TSNTMMPU  -  Choice  4  (Test  Timeout) 


Test  Configuration: 


TSNTMMPU  attempts  to  start  "DUMMYMPU''  on  a  paired  message 
(non-specific  initiation) .  The  startup  message  will 
timeout  and  the  UIV  MPU  will  return  a  timeout  expired 
message . 

Test  Purpose: 

1.  Message  Pair  Table 

2.  Pair  Timout  Checker 

3 .  Timeout  Expired  Message 

Services  Tested; 

RCV  (Timeout-Expired) 
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Test  Name;  TSNTJ1MPU  -  Choice  5  (Bad  Initiation) 
Test  Configuration: 


Test  Description; 

TSNTMMPU  attempts  to  start  TSAP3MPU  on  a  non-specific 
initiation  message  (in  this  case,  category  "E") . 
TSAP3MPU,  however,  has  the  characteristic  of  requiring  a 
specific  initiation  message.  An  error  message  will  be 
displayed  at  the  operator's  console.  The  source  AP  will 
also  be  informed  of  the  error  condition. 

Test  Purpose; 


1.  MPU  Logic  for  "restricted"  AP's. 

Services  Tested 

TSTMOD 

SIGERR 
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Test  Name:  TSNTMMPU  -  Choice  6  (Fill  Mailbox) 
Test  Configuration: 


TSNTMMPU 
(UIV  APC) 


Test  Description: 

TSNTMMPU  sends  three  messages  that  (a)  contain  the  maximum 
number  of  bytes  for  a  single  message  and  (b)  are 
sequentially  numbered.  TSAPAMPU  will  receive  the  messages 
and  respond  to  each  with  a  message  containing  the  number 
of  the  received  message.  TSAPAMPU  will  terminate  upon 
receipt  of  a  termination  request  from  TSNTMMPU. 

Test  Purpose: 

1.  Serial  message  queues. 


_ Large  Mest»Q«s 

Large  Message  Retponaet 
Termination  Request 
Termination  Meitaqe 


TSAPAMPU 
(TIV  APC) 
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Test  Name:  TSNTMMPU  -  Choice  7  (WHTHST) 
Test  Configuration: 


Test  Description: 

TSNTMMPU  requests  an  AP  name  (with  directory  prefix)  from 
the  user.  TSNTMMPU  will  then  call  ''WHTHST”  with  the  given 
AP  name.  The  WHTHST  return  will  be  displayed  to  the  user. 

Test  Purpose: 

1.  WHTHST  Service. 


5-33 


DS  620342000 
30  September  199C 


Test  Name:  TSSERMPU-Choice-1  (Invalid  Destination) 
Test  Configuration: 


- » 

Message 

to  JUNKflMPU 


Test  Description: 

TSSERMPU  sends  a  message  to  *'JUNKMPU"  which  has  neither 
existence  or  records  in  the  tables.  The  AP  will  receive 
the  "SEND-INVALID-DESTINATION"  return  on  the  "NSEND”  call. 
An  error  message  will  also  be  sent  to  the  monitor  AP.  (The 
error  message  will  be  displayed  on  the  operator's  console 
as  "3 102 4 -ACT"  entry  not  found  in  Authority  Check  Table) . 

Test  Purpose: 


TSSERMPU 
(UIV  APC) 


1.  MPU  message  management  logic. 

2.  Send  returns. 

Service  Tested: 


NSEND  (SEND-INVALID-DESTINATION) 
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T$SE«MPU 
(U!V  APC) 


Oau 

UatMgii 


Oau 


Maiwg« 

Ou»«i« 

(UIV  APC) 


Mtufn 


minnion  W«tug« 


TSAPMPU 
IT IV  APCI 


Stiutdo* 

APC 


NTMONITV 
(MRV  APC) 


Operator* 
Cert  tola 


Syttaai 

Coatfiiandt 


•  a...*  am* 


Test  Description: 

This  is  no  longer  a  valid  test  because  a  change  in  the  NTM 
logic  in  Rel.  1.1  now  forces  messages  for  an  off-APC  that 
is  currently  not  available  to  be  rejected  rather  than 
queued  for  later  delivery  (only  guaranteed  delivery 
messages  will  be  queued  for  later  APC  delivery.)  A 
'•Resource  Unavailable"  message  is  sent  to  APs  who  are  set 
to  receive  asynchronous  status  messages  from  the  NTM  on 
the  event  of  an  unavailable  APC  on  a  message  delivery 
request.  The  test  can  be  run  without  shutting  TIV  down 
but  it  does  not  test  anything  new.  The  test  AP  TSSERMPU, 
is  not  written  to  accept  or  display  the  Resource 
Unavailable  message. 
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Test  Name:  TSSERMPU-Choice-3  (Check  Hot  Messages) 
Test  Configuration: 


Test  Description: 

Choice-4  enters  a  loop  that  repeatedly  checks  the  hot 
mailbox  for  a  message.  If  a  hot  message  is  found,  the 
type  is  interpreted  and  an  appropriate  display  is  shown. 
The  test  operator  should  enter  an  "SD"  Command  at  the 
operator's  console  after  starting  this  test  and  respond 
with  a  time  greater  than  zero  on  the  "minutes  to 
shutdown?"  request.  The  test  AP  TSSERMPU  should  receive 
the  shutdown  pending  message  and  terminate.  The  IISS 
shutdown  should  proceed. 


Test  Purpose: 

1.  MPU  Shutdown  Pending  Logic 

2 .  MPU  Shutdown  where  an  AP  has  it ' s  own  Shutdown 
Logic. 

3.  Cancel  Shutdown  Logic. 

Service  Tested 

CHKMSG 

RCV 
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Test  Name:  TSSERMPU-Choice-4  (Fill  Log) 

Test  Configuration: 


Log  Tabit 
Entrias 


Test  Description: 

TSSERMPU  calls  "LOGON”  15  times.  As  the  logon  table  has 
an  occurs  of  10,  at  least  five  of  the  entries  will  have  to 
be  written  to  a  file.  After  the  entries  are  written  they 
will  be  deleted  via  15  calls  to  "LOGOFF". 

Test  Purpose: 

1.  Table  File  Access  on  Write  and  Delete  Functions. 
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Blank  Messages 

TSSERMPU 

Request  Messaaes 

TSPASMPU 

(UIV  APC) 

^  ResDonse  Messaaes 

(T1V  APC) 

Test  Description: 

TSSERMPU  sends  80  messages  to  TSPQSMPU  (Queue  Server) 
before  calling  RCV.  As  TSPQSMPU  will  be  responding  to  the 
40  request  messages  long  before  TSSERMPU  calls  RCV,  the 
response  messages  will  have  to  be  queued  at  UIV  APC. 
Noticeable  delays  in  the  display  of  the  messages  sent  and 
received  will  occur  during  the  processing  of  this  test. 
This  is  because  of  the  timer  delays  that  occur  before  the 
queued  messages  are  processed. 


Test  Purpose: 


1.  AP  Queue  Handling. 

2.  Buffer  Capacity. 
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Test  Name:  TSSERMPU-Choice-6  (Hot  Mailbox) 
Test  Configuration: 


SUrt  Message  ^ 

TSSERMPU 

Error  Messaae 

TSAP2MPU 
(T1V  APC) 

(UIV  APC) 

Termination  Message 

Test  Description: 

TSSERMPU  sends  a  message  to  TSAP2MPU  that  will  cause 
TSAP2MPU  to  call  RCV  for  a  "hot"  message.  As  TSAP2MPU 
does  not  support  a  "hot"  mailbox,  it  will  receive  an  error 
return.  This  return  will  be  sent  to  TSSERMPU  in  a  message 
from  TSAP2MPU.  TSAP2MPU  will  then  terminate  itself. 

Test  Purpose: 


1.  AP  Characteristic  of  Number  of  Mailboxes  Supported. 

2.  RCV  handling  of  an  invalid  call. 
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Test  Name:  TST12MPU-Choice-l  (No  Mailbox) 
Test  Configuration: 


Start  Mettaqe 

TST  12MPU 

Test  Messaqe  ^ 

TSAPBMPU 

(UIV  APC) 

Termination  Messaqe 

(TIV  APC) 

Test  Description: 

TST12MPU  starts  TSAPBMPU.  TSAPBMPU  has  the  characteristic 
of  having  no  mailboxes.  When  TST12MPU  sends  a  message  to 
TSAPBMPU,  an  error  message  will  come  back.  TSAPBMPU  will 
terminate  itself. 

Test  Purpose: 

1.  "No  Mailbox"  logic  in  INITAL,  RCV,  and  MPU. 
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Test  Name:  TST12MPU-Choice-2  (Fill  Core) 
Test  Configuration: 


User 

Sp«cifitd 

Count 


Test  Description: 

TST12MPU  sends  a  series  of  specific  initiation  messages  to 
TSAPCMPU  in  order  to  fill  the  in-core  dynamic  tables. 
TSAPCMPU  will  start,  call  RCV,  and  terminate.  TST12MPU 
will  receive  AP  Ending  messages  equal  to  the  number  of 
initiation  messages  sent. 

Test  Purpose: 

1.  Fill  in-core  tables  in  order  to  test  table  handling 

when  writing  to  a  file. 
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Test  Name:  TST12MPU-Choice“3  (Paired  Initiation) 
Test  Configuration: 


Paired  Initiation  Message 

TST12MPU 

Paired  Reponse 

TSAPDMPU 

(UIV  APC) 

Termination  Messaae 

(TIV  APC) 

Test  Description: 

TST12MPU  sends  a  paired  initiation  message  to  TSAPDMPU.  A 
new  instance  of  TSAPDMPU  will  be  started  and  it  will 
respond  to  the  message.  TSAPDMPU  will  then  terminate 
itself. 

Test  Purpose: 

1.  ISEND  logic  for  sending  paired  messages. 

2.  MPU  logic  to  handle  category  ''J”  messages. 
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Test  Name:  TST12MPU-Choice-4  (Long  Initiation) 
Test  Configuration: 


Test  Description: 

TST12MPU  sends  a  continued  initiation  message  to  TSAPDMPU. 
A  new  instance  of  TSPDMPU  will  be  started.  It  will  call 
RCV  and  return  the  number  of  bytes  of  data  received  in  a 
message  to  TST12MPU.  TSAPDMPU  will  then  terminate  itself. 

Test  Purpose: 

1,  ISEND  logic  for  sending  continued  messages. 
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Test  Name:  TST12MPU  -  Choice  5  (Run  Queue) 

Test  Configuration: 


Test  Description: 

TST12MPU  starts  TSAP5MPU,  TSAP6MPU,  and  TSAP7MPU.  Each  AP 
begins  sending  a  series  of  three  messages  to  the  Queue 
Server  (TSPQSMPU) .  TST12MPU  also  sends  a  message,  creating 
the  situation  where  four  AP's  are  communicating  with  the 
same  instance  of  the  queue  server.  At  the  end  of  the 
dialog,  TSAP5MPU,  TSAP6MPU,  and  TSAP7MPU  inform  TST12MPU 
that  they  are  finished.  When  TST12MPU  has  heard  from  all 
the  AP's  it  tells  TSPQSMPU  to  shutdown. 
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This  test  was  at  one  time  driven  by  TSPUIMPU.  Due  to  the 
handling  of  a  Queue  Server  as  a  "child"  of  the  NTM,  the 
source  AP  has  no  way  of  knowing  when  a  Queue  server  has 
terminated.  The  source  will  continue  to  send  messages  to 
a  (possibly)  dead  AP.  This  test  was  moved  to  avoid  this 
occurrence . 


Test  Purpose: 

1.  Multiple  Parents  per  instance. 

2.  Message  Queues. 

3.  Delivery  of  messages  to  a  Queue  Server  Type  AP. 

Services  Tested: 

RCV  (Message  Buffer  Logic) 

NSEND 

GETUSR 
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TSPUIMPU 


(UIV  APC) 


Startup 


Vaiugct 


NTMONITV 
(MRV  APC) 


Shutdown 

Vesaaees 


Shutdown  APC 


Operator's 

Console 


Test  Description: 

There  are  two  variations  on  this  tes 

1.  The  user  enters  Choice  5  follow 
the  Operator  entering  the  Shutd 
(TIV) .  In  this  case,  some  of  t 
be  in  the  initiation  stage. 
Monitor  to  that  effect. 

2.  The  user  enters  Choice  5.  T 
all  the  AP's  are  active  and 
Shutdown  APC  Command.  As  no 
shutdown  logic,  they  will  be 
terminated  message  is  sent  t 


have 
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Test  Purpose: 

1.  APC  Shutdown  Logic  with  AP's  still  in  initiation 
phase . 

2.  APC  Shutdown  Logic  with  active  AP's  on  cluster. 
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Test  Name:  TSSUIMPU  -  Choice  1,2,3 
Test  Configuration: 


call 

TO 

SET 


TSSUIMPU 

Sti^t  MSC  Th#t  Co^tamt  TK# 

Of 

TSSIGMPU 

1  Peouii'  with  NSSNDt 

«UIV  APCI 

^  Error  Uett*9«t  -  Cvncrttctf  «itK 

(T1V  MPU) 

Si9*rr  Callt* 

#  TSTMOD  SERVICE  i 

''  Tarmirtaiiori  Mataaga 

♦Sigerr  generated  messages  are  also  directed  to  the 
monitor,  and  can  be  displayed  by  entering  "SE"  at  the 
operator's  console.  The  default  at  IISS  startup  is  for  no 
logging  of  Sigerr  generated  messages  at  the  operator's 
console. 


Test  Description: 

TSSUIMPU  tests  the  three  user  testmodes  that  are  setable  by 
calls  to  TSTMOD  in  the  three  TSSUIMPU  test  choices.  On  Choice 
1,  TSTMOD  is  called  to  request  the  receipt  of  all  messages  by 
the  test  program.  It  also  requests  the  tester  to  enter  a  number 
that  will  tell  the  test  program,  TSSIGMPU,  the  number  of 
messages  to  generate  in  this  test.  On  its  startup,  TSSIGMPU  in 
all  of  the  choices  will  loop  through  a  series  of  regular 
messages  sends,  then  Sigerr  generated  messages  of  severity 
levels  (I,  informatory;  W,  warning;  F,  fatal).  On  Choice-1,  the 
test  screen  should  display  the  received  list  of  messages  and 
their  types.  This  list  should  contain  a  cycle  of  a  regular 
message  followed  by  error  messages  of  Severity  I,  W,  and  F. 

On  Choice  2,  TSTMOD  is  called  to  request  that  no  error 
messages  be  sent  to  the  user  Screen.  Again,  the  tester  must 
supply  the  number  of  messages  of  each  class  that  TSSIGMPU  should 
generate.  TSSIGMPU  cycles  through  its  message  series  in  the 
same  manner  as  in  Choice-1,  but  in  this  test  the  only  messages 
that  are  displayed  are  the  regular  messages  and  the  I 
(Informatory)  messages  generated  by  TSSIGMPU  calls  to  Sigerr.  A 
verification  that  TSSIGMPU  is  generating  all  classes  of  Sigerr 
messages  can  be  made  by  enabling  SE  at  the  operator's  console 
and  making  sure  that  error  messages  of  all  types  have  been 
received  at  the  operator's  console  during  the  test. 

On  Choice  -3,  TSTMOD  ^.s  called  to  request  that  the  only 
Sigerr  generated  error  messages  it  should  receive  are  the  fatal 
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TSMOD  Service  Test. 

Sigerr  Service  Test. 

"SE"  Operator's  command  test 

New  RCV  logic  to  support  filtering  necessary  with 
the  TSTMOD  flag. 
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Test  Name:  TSGDMMPU  -Test  Guaranteed  Delivery  Service. 

Test  Configuration: 


TSCOikWPU 
(UIV  APC) 


TSCDRMPU 
(TIV  APC) 


It) 

C«t»gorY  ■*“ 


Cu*r|nl««d  Delivery 

(CO)  Mettegc 


NTUIVMPU 


(2) 


(5) 


l«) 

*rm  Ahve” 

CO  Mttug* 

-* 

Trr 

■CA*  Tyq«  -  U»«r 

1  i  1 

CO  ACK 

-» 

i 

I  ,  . 

♦ 

(CD) 

-cx- 

• 

eVTyp. 

Typ« 

NTM-ACK  back 

NTlm-  ACX 

Mtlt»OC  ^or  CO 

'or 

Metugt 

:: _ 

CD  minQt' 

1 

It) 


-CA- 

Ueiteqr 


NTTIVMPU 


Test  Description: 

TSGDMMPU  tests  the  NTM's  guaranteed  delivery  logic,  and  the 
two  services,  GDSEND  and  GDACK.  On  the  startup  of  TSGDMMPU,  a 
guaranteed  delivery  (GD)  message  is  requested  with  the  service, 
GDSEND.  A  messac;e  of  category  "A”  (GD)  is  generated  for 
TSGDRMPU.  After  it  has  been  accepted  (logged)  by  NTUIVMPU,  a 
message  "GD  Message  Accepted”  should  appear  on  the  test  screen. 
The  rest  of  the  test  needs  to  be  verified  by  checking  the 
NTMLOG . 

If  the  test  worked  correctly,  after  NTTIVMPU  receives  the 
"A"  category  message  from  TSGDMMPU,  it  should  send  an  NTM-GD 
acknowledgment  to  NTUIVMPU  (message  type:  "GX") .  NTUIVMPU 
should  then  send  an  NTM-GD  AckBack  message  (message  type:  "GI") 
to  NTTIVMPU.  On  its  receipt  of  the  GD  message,  TSGDRMPU  should 
send,  via  GDACK,  a  user  GD  acknowledgment,  message  type  "GA" , 
before  terminating. 

Test  Purpose: 

1.  Test  GDSEND  Service. 

2.  Test  GDACK  Service. 

3.  Test  MPU  handling  of  GD  messages. 

5.2.4  Formal  Qualification  Tests 

Formal  Qualification  testing  will  be  designed  and  performed 
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PREPARATION  FOR  DELIVERY 


The  software  associated  with  this  NTM  CPCI  release  will  be 
delivered  on  a  media  which  is  compatible  with  the  IISS  Test  Bed. 
The  release  will  be  clearly  identified  as  to  release,  date, 
content,  format  and  function  and  will  include  instructions 
on  procedures  to  be  followed  for  installation  of  the  release. 
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APPENDIX  A 


A.l  Terms  and  Abbreviations 


This  paragraph  contains  definitions  of  IISS  related  terms 
and  general  computer  terms  that  are  used  in  this  document.  In 
addition,  it  contains  definitions  for  selected  terms  used  in  a 
the  IDEFO  Model  (Appendix  B)  and  serves  in  lieu  of  a  formal 
model  glossary. 

AP 

See  Application  Process. 

Abnormal 

Stoppage  of  a  process  prior  to  its  normal 
completion. 

Termination 

(Abort) 

Alive  AP 

An  application  process  that  is  capable  of 
being  initiated. 

Application 

Process 

Within  the  IISS  Architecture;  a  cohesive 
unit  of  software  that  can  be  initiated  as  a 
unit  to  perform  some  function  or  functions. 
See  also:  Process. 

Application 

Process  Cluster 

A  logically  related  group  of  application 
processed  that  resides  on  a  single  host 
system.  The  application  processes  are 
collected  at  a  single  cluster  because  of 
their  common  need  to  access  the  same 
database.  (In  previous  NTM  documents  this 
concept  was  referred  to  as  "Workstation") . 

Authorization 

A  relationship  between  message  type  a 
legal  paths  of  messages  conforming  to  that 
type. 

Awake  AP 

An  application  process  that  is  currently 
executing . 

Backlog 

Messages  waiting,  in  a  queue,  to  be 
processed . 

CDMRP 

See  Common  Data  Model  Request  Processor. 

COMM 

See  Communications  Handler. 

CPCI 

Computer  Program  Configuration  Item.  A 
cohesive  testable  (stand-alone)  system  with 
well-defined  external  interfaces. 

Clean  Point 

A  baseline  of  the  entire  system  state  at  a 
given  point  in  time  so  that  recovery  is 
possible  from  that  point. 

Cluster 

See  Application  Process  Cluster. 
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Common  Data 


Common  Data  Model 
(CDM) 


Common  Data  Model 
Request  Processor 


Communications 

Handler 


DBMS 

DML 

Database 


Data  Base 
Management  System 


Data  Manipulation 
Language 


Destination 


Heterogeneous 


Homogeneous 

Host 

Host  Machine 
IISS  Component 
IIGS  Operation 


Information  that  may  be  shared  among  users 
and  is  subject  to  policies  and  procedures 
of  the  IISS. 

A  description  of  the  data,  its  structure, 
allowable  operations,  and  integrity 
constraints  for  data  of  common  interest 
within  the  IISS. 

The  implementation  of  the  CDM  within  the 
IISS.  The  current  design  specifies  the  use 
of  extremities. 

An  IISS  Configuration  Item  that  services 
IISS  network  communications.  It  accepts 
messages  from  the  NTM  for  off-host 
destinations.  It  provides  NTM  with 
messages  from  off-host  sources. 

See  Data  Base  Management  System. 

See  Data  Manipulation  Language. 

A  collection  of  logically  related  data 
managed  by  a  DBMS . 

A  computerized  system  consisting  of 
numerous  components,  which  have  as  their 
collective  purpose  the  implementation, 
management,  and  protection  of  large-scale 
data  bases. 

A  formal  language  for  specifying  data 
modification,  and  retrieval  functions  under 
a  DBMS. 

An  application  process  (which  may  be  user 
role)  to  which  a  message  is  sent. 

Composed  of  parts  of  different  kinds; 
having  widely  dissimilar  elements  or 
constituents . 

Composed  of  parts  all  of  the  same  kind. 

See  Host  Machine. 

A  configuration  of  a  processor(s)  and 
associated  peripherals. 

Application  Processes  involved  in  IISS 
support  activities.  See:  CDMRP,  UI,  COMM. 

Messages  entered  directly  to  the  NTM  by  an 
operator . 
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Messages 
IISS  Shutdown 

IISS  Startup 
Integrated  AP 

Initiation  Message 

LAN 

Load 

MDL 

MM 

Maintain 

Operability- 

Message 

Message  and  Error 
Log 

Message  Category 

Messages  from 
Of  f-Cluster 

Message  from 
On-Cluster 


These  include:  startup,  shutdown,  restart, 
and  provide  status  and  statistics. 

A  signal  or  IISS  operator  command  that 
initiates  the  orderly  shutdown  of  the 
entire  IISS  system  or  an  individual 
workstation. 

A  signal  or  IISS  operator  command  that 
initiates  the  IISS  on  a  single  host. 

An  application  process  designed  and  written 
in  accordance  with  the  IISS  Integration 
rules . 

A  message  that  specifically  requires  the 
initiation  of  an  application  process.  The 
message  may  also  carry  data  for  that 
process . 

Local  Area  Network. 

To  bring  a  bound  (linked)  set  of  computer 
instructions  into  a  computer  memory  unit  in 
preparation  for  its  execution  as  a  process. 

Message  Definition  Language.  Neutral  syntax 
and  semantics  for  formatting  IISS  messages. 

See  Message  Manager. 

The  name  given  to  that  part  of  the  NTM  that 
will 

Facilitate  system  wide  services  of  restart, 
recovery,  shutdown,  and  system  status 
monitoring  and  recording. 

A  structured  unit  of  information. 

The  record  of  messages  (legal  and 
erroneous)  that  are  processed  by  the 
message  manager. 

A  group  of  message  types  sharing  common 
processing  requirements. 

Any  message  that  has  as  its  source  an  AP  or 
NTM  that  is  not  resident  on  the  cluster  in 
question . 

Any  message  sent  by  a  local  AP  that  is 
directed  to  another  on  APC  AP  or  to  another 
NTM  (i.e.,  requiring  the  routing  services 
of  the  Message  Manager) . 
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Message , 
Definition 


Message  Manager 


Message  to  IISS 
Operator 


Messages  to 
Off-Cluster 


Message  to 
On-Cluster 


Message  to  be 
Routed 


The  legal  (recognized  and  allowed)  values 
to  which  a  message  must  conform  to  be 
accepted  for  processing  at  an  AP  on  a  given 
APC  on  a  given  host.  The  values  are 
contained  in  tables  which  are  defined  in 
Section  3.5.3 

The  name  given  to  the  part  of  the  NTM  that 
will  provide  the  service  for  the  identified 
Manage  Message  functions  (see  DS/Al  Section 
10.2)  . 

Typically  a  response  to  an  operation 
request.  This  message  could  also  be  a 
request  for  operator  action. 

Any  message  that  has  as  its  sgurce  an  AP  or 
NTM  that  is  not  resident  on  the  cluster  in 
question. 

Messages  directed  to  an  AP  (resident  on  the 
cluster)  that  contain  information  necessary 
for  the  process  to  perform. 

A  message  that  has  another  AP  as  its 
destination. 


Message  Type 


MO 


The  identification  of  the  nature  of  a  given 
message. 

See  Maintain  Operability. 


MO  Data  and  Status  Any  message  directed  to  the  maintain 
Messages  operability  function. 


Native  Mode 


Character  code  native  to  a  particular 
machine,  either  ASCII  or  EBCDIC. 


Network 


Non-integrated  AP 


NTM 


OS 

OS  Process  Control 
Response 


Several  computers  and  a  communications 
facility  connecting  them. 

An  Application  Process  designed  without 
adherence  to  the  IISS  Integration  rules. 

Network  Transaction  Manager.  That  portion 
of  the  IISS  that  manages  messages  and 
application  processes  and  maintains  the 
operability  of  the  IISS. 

See  Operating  System. 

Response  from  the  host  operating  system  to 
a  request  for  services,  (i.e.,  process  ID 
assigned,  process  exists,  process  does  not 
exist) . 
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OS  Process  Control 
Request 

On-APC  AP  Messages 

Operability 

Messages 

Operating  System 

Priority 

Process 

Process  Manager 

Process  Name 

Requirement 

Resources 

Source 

Status  and 
Statistics  Log 

System 

Task 


Request  for  services  to  be  provided  by 
the  host  operating  system. 

Any  message  that  has  as  its  destination  an 
AP  that  is  resident  on  the  workstation  in 
question. 

Messages  initiated  by  maintain  operability 
to  handle  an  IISS  operation  request  and  to 
monitor  the  IISS  system. 

Software  that  controls  the  execution  of 
computer  programs  and  that  may  provide 
scheduling,  debugging,  input-output 
control,  accounting,  compilation,  storage 
assignment,  data  management,  and  related 
overall  system  management. 

The  expectation  of  processing  urgency 
assigned  to  a  message  type.  The  recognized 
transaction  priorities  are:  standard, 
immediate  and  time-triggered. 

The  basic  unit  of  work  from  the  standpoint 
of  the  computer's  operating  system. 

The  name  given  to  the  part  of  the  NTM  that 
will  provide  the  service  for  the  identified 
Manage  Processes  function.  (See  DS/A2, 
Section  10.2) 

The  AP  Name  and  instance  identifier  of  an 
initiated  AP. 

Stated  functions  for  information  processing 
and  associated  constraints. 

People,  hardware,  software,  and  other 
components  used  to  process  information. 

An  Application  Process  from  which  a  message 
is  sent. 

Data  regarding  the  AP  status,  resource 
utilization,  message  traffic  provided  in 
response  to  an  operation  request. 

A  collection  of  people,  hardware,  software 
and  methods  organized  to  accomplish  a  set 
of  specific  functions. 

See  Process. 
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UI 

Update 


User 


User  Application 
Process 

User  Interface 

View 

Workstation 


A  collection  of  computer  hardware, 
software,  storage  devices,  and  other 
peripherals  used  for  testing  application 
software  and  system  concepts.  Usually  not 
the  target  operational  system. 

See  User  Interface. 

The  process  of  changing  values  in  all  or 
selected  entries,  groups,  or  data  items 
stored  in  a  database  or  adding  or  deleting 
data  occurrences. 

Human  being  who  requests  processing  to  be 
done.  The  person  entering  a  transaction  at 
a  terminal.  The  user  can  also  be  a 
non-human  that  performs  these  functions  but 
this  term  will  not  be  used  in  this  sense  in 
this  specification. 

Any  application  process  not  involved  in 
IISS  support 

An  application  process  that  manages  the 
user-terminal  interface. 

That  which  is  within  the  range  of  vision. 
Also,  that  data  which  is  of  interest  to  a 
specific  application  process. 

See  Application  Process  Cluster 
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APPENDIX  B 


B.l  IDEFO  Model  of  the  NTM 


The  model  presented  here  represents  conceptual  view  of  the 
IISS  and  the  workstation  environment  in  which  the  NTM  will 
operate  (ENV/A-1)  along  with  the  functional  breakdown  of  the  NTM 
components.  The  description  of  the  functional  processing  shown 
in  the  model  is  found  in  Section  4.2  and  serves  in  lieu  of  text. 
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ENV/A-lTl 


Thf>  h«5ls  of  the  IISS  architecture  Is  the  concept  of  fP  clusters.  An  AP  cluster  Is  derinad  as  a 
hlrfily  crhesive  qrai(>  (one  or  More)  of  Application  Processes  thet  have  either  one  or  no  Database  Manager 
(and  hy  eitenslnn,  database)  In  coawon.  This  concept  allows  Tor  the  Isolation  of  application  functions 
iMsed  upon  the  data  they  need  to  access.  The  tISS  coaponents,  the  User  Interface  (Ul),  Coanuilcatlons 
Handler  (rrsM),  and  Cnaaon  Oats  Model  Request  Processor  (CCMF)  are  seen  as  Application  Processes  that  eech 
reside  on  e  distinct  AP  cluster.  Non- Integrated  or  Tilstlng*  Applications  (applications  designed  without 
arSierenre  to  IISS  Integration  rules)  also  reside  on  separate  AP  clusters  In  accordance  with  the  rule  that 
they  access  one  database.  Integrated  or  "Tiew"  Applications  (applications  desired  and  written  In  accordMKe 
with  the  IISS  Integration  Rules)  will  either  reside  on  separate  AP  clusters  or  be  added  to  existing  AP 
chisters  depending  ipen  detHhase(s)  they  need  to  access. 

An  Application  Process  (AP)  within  the  IISS  architecture  Is  a  nheslve  letlt  of  software  that  can  be 
Initiated  as  a  iwilt  to  perform  sone  fmrtlon  or  functions.  All  APs  within  the  IISS  are  treated  In  the  saae 
annner  hy  the  NIM. 

Some  exaeples  of  APs  In  the  IISS  are;  User  Application  Processes  such  as  an  ioe«  coapmnt  capable  of 
prnressinq  a  tranvretion;  and  IISS  camponents  such  as  the  User  Interface,  Coaaxnlcatlon  Handler,  and  Coanon 
hnta  Mndel  Re(y»st  Pmcessnr.  The  MTM's  concern  In  all  cases  Is  to  provide  a  transparent  logical  llrk  ftem 
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EN 


iviy  «P  tfl  any  other  AP  In  the  IISS  ayste*.  Each  AP  Is  seen  by  the  NTN  as  a  stwid-alone  mlt  that  is  fully 
caoahle  of  fwrforelng  Its  oiai  processing  and  noraally  terslnatlng  Itself. 

The  NTM  provides  the  conmon  operating  thread  for  each  AP  cluster.  An  NTm  *111  be  associated  alth  each 
AT  cluster  to  provide  for  Message  Management,  process  Management,  and  to  maintain  AP  cluster  «id  syste* 
cperahlllty.  These  functions  are  discussed  In  detail  In  the  HTM  OS  ttodel  belo*. 

The  NTM  Is  an  AP  cluster’s  contact  point  vlth  the  rest  of  the  IISS  "•orld.*  Messages  fnsa  outside  the 
AP  cluster  (111)  are  received  by  the  NTM  (Box  1).  The  NTM  determines  nhether  the  Message  belongs  to  tlw  AP 
cluster  based  lyinn  the  ta'ssage  Oeflnltlon  (ICl).  lAtere  the  Message  does  not  belong  to  the  AP  cluster  (for 
reasons  discussed  In  NTMIS/Al)  the  Message  Is  sent  off  the  AP  cluster  (101).  iCwre  the  Message  does  belong 
to  the  AP  cluster,  It  Is  delivered  to  the  appropriate  Application  Process  (1(B).  Wwre  the  Message  belor^ 
to  the  AP  cluster,  the  NTM  *111  use  the  host  OS  services  (103)  to  perform  ftretlons  as  needed.  OS  process 
control  responses  (113)  are  sent  to  the  NTM. 

The  NTM  (Box  1)  uses  the  Host  OS  services  (Box  2)  to  control  the  application  process  (Box  3).  during 
the  process  or  upon  completion  of  processing  «hen  the  need  arises  to  send  a  message  to  a  user  or  to  access 
another  Application,  the  processing  AP  will  Pend  a  message  to  the  NTM  (301).  TTw  NTM  receives  the  aessage 
(117),  processes  and  rnites  It  to  the  appropriate  application  either  on  (IIB)  or  off  (101)  the  AP  cluster. 
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V/A-1T2 


In  Ihls  erwiroTPcnt,  the  fuxtlons  thet  we  pctIotwhI  by  the  Host  05  (Bo»  2)  end  the  ervllcatlon 
process  (Box  ^)  are  outside  the  Jurisdiction  of  the  NTH. 


the  rinctlon  of  Maintaining  the  AP  cluster  is  also  provided  by  the  nTM.  Messages  regarding  aystea 
orvratlon  (startup,  shutdbwi,  recover,  restart)  are  sent  to  the  NTH  (ICl). 
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E— : 

hSi 

i(nT" 

lEin 

Th*!  scmnrlo  sequence  described  for  EW/A-1  deviates  sll^tly  for  t»o  «P  clusters;  the  User  Interface 
(III)  wvl  the  Comnlcatlons  Handler  (CXM4).  This  Is  due  to  the  fact  thet  e  eessage  can  be  received  by  the 
111  nr  Cfbfi  Application  process  prior  to  NTH  processing.  Note  that  the  only  difference  laplied  in  these  FCOt 
Is  the  order  In  vhich  a  aessage  Is  passed  among  the  functions  on  the  AP  cluster.  The  NTM  fuictlcns  and 
interfaces  are  exactly  the  same  In  all  cases. 

The  User  Interface  AP  (Box  3  on  ri)  receives  a  message  froai  a  user  at  an  IISS  terminal  Oil).  The  User 
Interface  AP  *111  Interact  elth  the  user  (301,  311)  to  gather  the  data  needed  to  fonulate  a  transaction 
■hich  vlll  then  he  sent  (30?)  to  the  NTm  for  routing.  Messages  routed  to  the  UI  from  another  AP  cluster 
Mill  he  received  first  by  the  NTM  and  handled  In  the  manner  described  for  CNV/A*!. 

The  Ul  AP  cluster  provides  for  the  Isolation  (domload)  of  the  screens  (menus)  that  facilitate  tha 
user's  Interaction  with  an  application  process.  This  isolation  removes  screens  from  an  AP  and  places 
them  closer  to  the  terminal.  Thus,  the  Ul-User  Interaction  allMS  the  forxulatlon  of  a  transaction  without 
the  necessity  of  Initiating  the  target  application  process,  further,  all  message  traffic  Involved  Is  kept 
within  the  AP  cluster  intll  the  transaction  Is  formed  and  routed  thereby  reducing  the  message  traffic  on  tl« 
IISS. 
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ENV/A-aFlT 


IITiT 


-RQBRI 


ENV/A-t  Ft 


NTM  ENVIRONMENT  ON  Ul  APC 
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ENV/A-lFl  -  DIAGRAM 


SiO  AT: 

AUTHOR: 

SofTech 

OATT:  9/17/82 

raOJSCT: 

NTN 

AfV: 

NOTTS:  t 

Hie  cow  AP  1$  (lihe  the  UI)  capable  of  receiving  a  aessage  prior  to  local  host  NTN  processing  of  the 
nessage. 

Ihe  COW  fP  provides  the  host-to-host  cosawnlcatlon  for  the  IISS.  t#«re  an  NTM  detcralnes  that  a 
■Kssage  belongs  to  a  AP  cluster  other  than  Us  ovn,  the  destination  Is  another  AP  cluster  that  Is  either  on 
the  sa«e  host  or  another  host  In  the  IISS.  Mhere  the  target  AP  cluster  Is  on  host,  the  aessage  la  sent 
to  that  AP  cluster's  NTM.  Mhere  the  target  AP  cluster  Is  off-host,  the  nessage  Is  sent  to  the  NTM  for  the 
host's  COW  AP  Cluster  (111).  The  off-host  Messages  are  sent  to  the  COW  AP  (Box  3)  fro*  lAilch  they  are 
sent  to  the  LAN  (301)  as  a  single  aessage  streae. 

The  deviation  from  the  Crw/A-l  scenario  vhen  Messages  cone  Into  the  COW  AP  froM  the  LAN  (311).  These 
Messages  are  received  by  the  COW  AP  vhlch  then  directs  then  to  the  COW  AP  Cluster  NTM  (302)  for  further 
routing. 
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PurppM:  ThI*  aMd«l  will  b«  uMd  lo  dsHn*  lh«  functton  of  Iho  NTM  at  Uioy  ralalo 
lo  a  tingla  APC  for  Iho  NTM  Dovalopwiont  Spoclflcallen. 

VIowpolnl :  An  Individual  Intlanco  of  an  NTM't  MPU  and  AP  Inltrfaca  Caoyonanla 
a«  a  aland  alono  tytloao  providing  aorvlcaa  lo  a  Chialor  of  Appllcallan 
Procataot  (APCI 
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APPENDIX  C 


C. 1  IDEFl  Model  of  the  NTM 

The  Model  presented  here  represents  the  structure  of  the 
data  required  to  perform  the  NTM  functions.  The  data  items 
identified  in  the  model  are  defined  in  Appendix  D  (in  lieu  of  a 
formal  glossary) .  The  table  usage  and  structure  is  defined  in 
Section  4.5.3. 
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APPENDIX  D 


D. 1  Data  Item  Descriptions 

Each  data  item  required  by  the  NTM  is  defined  below.  The 
items  are  presented  in  alphabetical  order  for  easy  reference. 
The  data  items  used  by  the  AP  interface  services  are  described 
in  the  System  Services  Manual  [8]. 


Data  Item  Name;  Access  Flag 


Data  Item  ID:  ACCFLG 


Data  Item  Description; 

Identifies  whether  the  access  to  a  given  AP  is  restricted 
or  open.  This  applies  only  to  messages  belonging  to 
categories  defined  as  requiring  authorization. 


Data  Item  Picture:  X 


Size  in  Bytes: 


Codinc 


Alpha/Numeric 


IDEFl  X  Ref. : 


Data  Item  Stability:  Static 


Legal  Value  Set  By; 
AP  Developer 


Where  Used;  Authority  Check  Table 


Legal  Values 


Restricted 


Value 

Representation 


Open 


Data  Item  Name:  ACK  to  Source  MPU 


Value  Definition 

Ap  has  restricted 
Access  -  requires  an 
authority  check 

AP  has  open  access  - 
no  authority 
required 

Data  Item  ID:  MPUACK 


Data  Item  Description; 

Identifies  whether  the  message  causing  the  initiation  of 
an  AP  conforms  to  category  E  (unsolicited  message) .  Where 
the  initiation  message  is  category  E,  the  destination  MPU 
will  return  an  unsolicited  Initiation  Accept  (message  type 
lA)  to  the  source  MPU. 


Data  Item  Picture:  X 


Codinc 


Alpha/Numeric 


Size  in  Bytes ;  1 

IDEFl  X  Ref.  :  N/A 
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Data  Item  Stability:  Dynamic  Legal  Value  Set  By: 

Message  Category 

Where  Used:  I'm  Alive  Table 

Value 

Legal  Values  Representation  Value  Definition 

No  Send  ACK  0  No  ACK  required  on 

initiation 

Send-ACK  1  ACK  required  on 

initiation 


Data  Item  Name:  AP  Cluster  "Cold"  Mailbox  Data  Item  ID:  APCCMB 
Data  Item  Description: 

The  name  of  the  mailbox  used  for  low  priority  messages 
coming  into  the  AP  Cluster.  The  messages  may  either  be  from 
a  resident  AP  or  from  another  cluster. 

The  priority  level  is  determined  by  the  message  category 
and  is  relative  to  the  NTM.  The  priority  under 
consideration  in  this  case  has  no  bearing  on  the  priority 
of  an  Application  Process. 

Data  Item  Picture:  X(14)  size  in  Bytes:  14 

Coding  Type:  Alpha/Numeric  IDEFl  XRef :  EC  2 

Data  Item  Stability:  Dynamic*  Legal  Value  Set  By: 

Derivation  from  APC 
Name 

Where  Used:  APC  Startup 

Value 

Legal  Values  Representation  Value  Definition 

Mon-VAX-C-MBX  MRVCbbbbbbbbbb**  VAX  Monitor  APC  Cold 

Mailbox 

Mon-IBM-C-MBX  MRICbbbbbbbbbb  IBM  Monitor  APC  Cold 

Mailbox 

User-Int-C-MBX  UIVCbbbbbbbbbb  User  Interface  Cold 

Mailbox 

COMM-VAX-C-MBX  COVCbbbbbbbbbb  VAX  COMM  APC  Cold 

Mailbox 

COMM-IBM-C-MBX  COICbbbbbbbbbb  IBM  COMM  APC  Cold 

Mailbox 

CDM-C-MBX  CDMCbbbbbbbbbb  CDM  APC  Cold  Mailbox 

*In  all  cases,  the  distinction  between  static  and  dynamic  data 
is  based  on  whether  the  data  is  obtained  from  the  CDM,  or 
generated  within  the  NTM.  Therefore,  data  obtained  from  the  CDM 
IS  static.  All  other  items  are  dynamic. 

**Note:  the  last  byte  in  the  mailbox  name  is  reserved  for 

non-NTM  use. 

Data  Item  Name:  AP  Cluster  "Hot"  Mailbox  Data  Item  ID:  APCHMB 
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Data  Item  Description: 

The  name  of  the  mailbox  used  for  high  priority  messages 
coming  into  the  AP  Cluster.  The  messages  may  either  be 
from  a  resident  AP  or  from  another  cluster. 


Data  Item  Picture:  X(14) 
Coding  Type:  Alpha/Numeric 
Data  Item  Stability:  Dynamic 


Size  in  Bytes ;  14 

IDEFl  XRef :  EC  2 

Legal  Value  Set  By: 
Derived  from  APC  Name 


Where  Used:  APC 

Legal  Values 

Mon-VAX-H-MBX 

Mon-IBM-H-MBX 

User-Int-H-MBX 

COMM-VAX-H-MBX 

COMM-IBM-H-MBX 

CDM-H-MBX 


Startup 

Value 

Representation 

MRVHbbbbbbbbbb* 

MRIHbbbbbbbbbb* 

UIVHbbbbbbbbbb 

COVHbbbbbbbbbb 

COIHbbbbbbbbbb 

CDMHbbbbbbbbbb 


Value  Definition 


VAX  Monitor  APC  Hot 
Mailbox 

IBM  Monitor  APC  Hot 
Mailbox 

User  Interface  APC 
Hot  Mailbox 
VAX  COMM  APC  Hot 
Mailbox 

IBM  COMM  APC  Hot 
Mailbox 

CDM  APC  Hot  Mailbox 


*Note:  The  last  byte  in  the  mailbox  name  is  reserved  for 

non-NTM  use. 


Data  Item  Name:  AP  Cluster  Name 


Data  Item  ID: 

APCNME 


Data  Item  Description: 

The  AP  Cluster  name  identifies  a  given  occurrence  of  an  AP 
Cluster  residing  on  the  IISS.  An  AP  Cluster  is  defined  as 
a  logically  related  group  of  application  processes  that 
reside  on  a  single  host  machine.  The  processes  are 
collected  at  a  single  AP  Cluster  because  of  their  common 
need  to  access  the  same  database.  A  cluster  may  not  have 
any  database  but  it  will  never  have  more  than  one. 

Each  cluster  within  the  IISS  is  controlled  by  its  own 
occurrence  of  an  MPU.  The  control  by  the  MPU  extends  to 
receiving  messages,  verifying  messages,  rejecting  bad 
messages,  routing  messaijes  to  their  appropriate 
destination,  and  servicing  the  resident  application 
processes  via  the  AP  Interface. 


D-3 


DS  620342000 
30  September  1990 


The  AP  Cluster  is  always  assigned  to  a  single  logical  host 
but  that  assignment  is  allowed  to  change.  The  tracking  of 
which  logical  host  the  AP  cluster  is  currently  assigned  to 
is  kept  in  the  APC  Status  Table. 

Data  Item  Picture:  X(3)  Size  in  Bytes :  3 

Coding  Type;  Alpha  IDEFl  XRef :  EC  2 

Data  Item  Stability:  Static  Legal  Value  Set  By: 

NTM  Developers 


Where  Used:  Message  Header;  APC  Status  Table;  AP  Information 
Table;  Logon  Table 


Legal  Values 


Value 

Representation 


Value  Definition 


Mon-VAX 


MRV 


Monitor  AP's  APC  on 
the  VAX  Supporting 
the  Operator's 
Console 


Legal  Values 
Mon-IBM 

User-Int 

Comm-Hdler-VAX 

Comm-Hdler-IBM 

CDM 


Value 

Representation 
MR  I 

UIV 

COV 

COI 

CDM 


Value  Definition 

Monitor  AP's  APC  on 
the  IBM 

User  Interface  APC 
on  the  VAX 

VAX  COM  AP  Cluster 

IBM  COM  AP  Cluster 

CDM  APC 


Data  Item  Name:  AP  Cluster  Status 


Data  Item  ID:  APCSTS 


Data  Item  Description: 

The  AP  Cluster  status  identifies  the  current  operational 
status  of  a  given  cluster. 


Data  Item  Picture:  X 
Coding  Type:  Alpha/Numeric 
Data  Item  Stability:  Dynamic 


Size  in  Bytes ;  1 

IDEFl  XRef:  EC  2 

Legal  Value  Set  By; 
Monitor  AP 


Where  Used:  APC  Status  Table 
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Legal  Values 

Clus-Up 

Clus-Unavail 


Value 

Representation 

1 

2 


Clus-Shutting-Down 


Value  Definition 

Cluster  is  up 

Cluster  is  not 
active 

Cluster  is  in 
Shutdown  Mode 


Clus-In-Startup  4  Cluster  is  in 

Startup  Mode 

Clus-Start-Flag  5  Cluster  to  be 

started  on  IISS 
startup 

Data  Item  Name :  Application  Process  Name  Data  Item  ID :  APNAME 
Data  Item  Description: 

This  data  item  identifies  a  unique  "generic"  Application 
Process  known  to  the  IISS.  An  AP  is  defined  as  a  cohesive 
unit  of  software  within  the  IISS  that  can  be  initiated  as 
a  unit  to  perform  some  function  or  functions.  Each 
application  process  name  is  considered  to  be  a  Legal 
System  Address. 


The  naming  convention  for  AP  names  is  to  reserve  the 
first  two  characters  for  the  name  of  the  subsystem  to 
which  the  AP  belongs.  The  second  three  characters  will 
identify  the  specific  process  within  the  subsystem. 

The  AP  name  is  the  key  portion  of  the  message  header 
source,  destination,  and  originating  source  fields.  It 
cannot,  by  itself,  provide  all  the  information  needed  to 
route  messages  and  is  therefore  concatenated  with 
Instance  (when  known)  and  resident  AP  Cluster. 


Data  Item  Picture :  X (8 ) * 
Coding  Type :  Alpha/Numeric 
Data  Item  Stability:  Static 


Size  in  Bytes :  8* 

Owner  IDEFl  XRef :  EC  17 

Legal  Value  Set  By : 
Application  Programme 
in  accordance  with  IISS 
naming  conventions* 


Where  Used:  AP  Information  Table;  Message  Header;  AP  Status 

Table;  Child  Table;  AP  Characteristics  Table;  Logon  Table; 
AP  Operating  Information  Table;  I'm  Alive  Table;  Authority 
Check  Table  NTM  System  Services 
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*AP  Naming  conventions  dictate  an  8  Character  base  Name. 
To  name  a  two  character  prefix  to  identify  the  directory 
where  the  AP's  executable  image  is  located  is  appended. 
This  ten  character  name  is  the  common  reference  to  the  AP 
throughout  the  NTM. 


Legal  Values 

Value 

Representation 

Value  Definition 

Monitor  AP 

NTMONITV 

Monitor  AP  on  the  VAX 

NTMONTI 

host  machine 

Monitor  AP  on  the  IBM 
host  machine 

Communications 

COMVICOM 

COMM  linking  the  VAX  to 

Handler 

the  IBM 

COMIVCOM 

COMM  linking  the  IBM  to 
the  VAX 

MPU-Mon-VAX 

NTMRVMPU 

MPU  serving  the  Monitor 
AP's  APC  on  the  VAX 

MPU-Mon-IBM 

NTMRIMPU 

MPU  serving  the  Monitor 
AP's  APC  on  the  IBM 

MPU-User-int 

NTUIVMPU 

MPU  serving  the  User 
Interface  APC 

MPU-COMM-Hdlr-VAX 

NTCOVMPU 

MPU  serving  the  COMM 

APC  on  the  VAX 

MPU-COMM-Hdlr-VAX 

NTCOIMPU 

MPU  serving  the  COMM 
APC  on  the  IBM 

MPU-CDM 

NTCDMMPU 

MPU  serving  the  CDM  APC 

Data  Item  Name:  AP  Cold  Mailbox  Data  Item  ID:  APCMBX 


Data  Item  Description; 

Identifies  the  low  priority  mailbox  for  a  given  instance 
of  an  application  process. 


Data  Item  Picture;  X(14)  Size  in  Bytes ;  14 

Coding  Type:  Alpha/Numeric  IDEFl  XRef :  EC  47 

Data  Item  Stability;  Dynamic  Legal  Value  Set  By ; 

AP  Interface 

Where  Used:  Message  Processing  Unit 
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Representation : 

01  AP-Cold-Mailbox 


03 

AP-Name 

PIC 

X(10)  . 

03 

AP-Instance 

PIC 

X(2)  . 

03 

Mailbox-Type 

PIC 

X  Value 

03 

Filler 

PICX 

Data  Item  Name;  AP  ACK  Mailbox  Data  Item  ID;  APAMBX 

Data  Item  Description; 

Identifies  the  name  of  the  mailbox  to  which 
acknowledgement  messages  are  to  be  sent. 

Data  Item  Picture;  X(14)  Size  in  Bytes;  14 

Coding  Type;  Alpha/Numeric  IDEFl  XRef ;  EC  47 

Data  Item  Stability;  Dynamic  Legal  Value  Set  By; 

AP  Interface 


Where  Used;  Message  Processing  Unit 
Representation ; 


01 


AP-ACK-Mailbox 
03  AP-Name 

03  AP-Instance 

03  Mailbox-Type 

03  Filler 


PIC  X(10) . 

PIC  X(2)  . 

PIC  X  Value  "A". 
PICX 


Data  Item  Name ;  AP  Hot  Mailbox  Data  Item  ID;  APHMBX 

Data  Item  Description; 

Identifies  the  low  priority  mailbox  for  a  given  instance 
of  an  application  process. 

Data  Item  Picture:  X(14)  Size  in  Bytes:  14 

Coding  Type;  Alpha/Numeric  IDEFl  XRef ;  EC  47 

Data  Item  Stability:  Dynamic  Legal  Value  Set  By ; 

AP  Interface 

Where  Used :  Message  Processing  Unit 
Representation: 

01  AP-Hot-Mailbox 


03 

AP-Name 

PIC 

X(10)  . 

03 

AP-Instance 

PIC 

X(2)  . 

03 

Mailbox-Type 

PIC 

X  Value  "H" 

03 

Filler 

PICX 
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Data  Item  Name;  AP  Priority  Data  Item  ID:  APPRC 


Data  Item  Description: 

The  priority  level  assigned  to  a  given  Application 
Process . 


Data  Item  Picture;  X 
Coding  Type:  Alpha/Numeric 
Data  Item  Stability:  Static 
Where  Used:  Message  Header;  AP 


Size  in  Bytes :  1 
IDEFl  XRef ;  EC  17 
Legal  Value  Set  By: 
Characteristics  Table 


Value 

Legal  Values  Representation  Value  Definition 

Default  0  Default  AP  Priority 

for  the  Test  Bed 

Data  Item  Name:  Application  Process  Status  Data  Item  ID:  APSTAT 
Data  Item  Description; 

This  item  defines  the  current  operational  status  of  a 
given  initiated  instance  of  an  application  process. 


Data  Item  Picture;  X 
Coding  Type;  Alpha/Numeric 
Data  Item  Stability:  Dynamic 


Where  Used;  AP  Status  Table 

Value 

Legal  Values  Representation 

AP-Init  0 


AP-Abort  1 

AP-Dead-Act-Cld  2 


Size  in  Bytes ;  1 

IDEFl  XRef;  EC  16 

Legal  Value  Set  By ; 
AP's  MPU 

Note:  All  of  these 
values  are  applied 
to  an  AP  instance  - 
Not  to  the  "generic" 
AP 


Value  Definition 


AP  is  in  initiation 
mode  ("I'm  alive" 
msg  has  not  yet 
arrived  at  MPU) 

AP  has  been  aborted 

AP  has  terminated 
but  its  child  AP(s) 
are  still  active 
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AP-Dead 

3 

AP  has  normally 
terminated 

Await-Init 

AP  is  waiting  for  an 
initiation  message 

Init-Canc 

5 

AP's  initiation  was 
canceled 

Shut-Down-Mode 

6 

AP  is  in  the  process 
of  shutting  down 

Legal  Values 

Value 

Representation 

Value  Definition 

In-Recovery 

7 

AP  is  in  recovery 
mode 

In-Wait 

8 

AP  is  waiting  on  a 
response  to  a  paired 
message 

Shut-Down 

9 

AP  has  completed 
shutdown  and  is  dead 

Recovered 

A 

AP  has  finished 
recovery  and  is 
available  for 
initiation 

AP-Executing 

B 

AP  is  executing 

Data  Item  Name;  Authorization  Data  Item  ID:  AUTREQ 

Requirement 


Data  Item  Description: 

The  authorization  requirement  identifies  whether  a  message 
conforming  to  a  given  category  needs  to  have  the  authority 
of  its  sender,  Message  Type,  and  receiver  checked. 


Data  Item  Picture ;  X 
Coding  Type:  Alpha/Numeric 
Data  Item  Stability;  Static 


Size  in  Bytes :  1 

IDEFl  XRef ;  EC  36 

Legal  Value  Set  By; 
Message  Category 


Where  Used;  Message  Category  Table 


Legal  Values 


Value 

Representation 


Aut-Yes 


1 


Value  Definition 


Aut-No 


0 
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Data  Item  Name:  Authorized  to  Receive  Data  Item  ID:  ATOREC 


Data  Item  Description: 

This  Item  is  not  a  pure  data  item.  It  is  the  name  of  the 
field  in  the  Authority  Table  that  contains  the  AP  Name 
that  is  authorized  to  receive  a  given  message  Type  from  an 
AP  Name  that  is  authorized  to  send  the  same  given  message 
type.  The  field  name  defines  the  function  of  the  values 
that  are  contained  in  the  field. 

The  values  in  the  field  are  represented  as  the  AP  Name. 


Data  Item  Name:  Authorized  to  Send  Data  Item  ID:  ATOSND 

Data  Item  Description: 

This  item  (as  Authorized  to  Receive)  is  a  field  name  in 
the  Authority  Table  which  defines  the  function  of  the 
values  that  are  contained  in  the  field.  The  value  in  this 
field  of  the  Authority  Table  is  the  AP  Name  that  is 
authorized  to  send  a  given  message  type  to  another  AP  that 
is  authorized  to  receive  the  same  given  message  type. 

The  values  in  this  field  are  AP  Names  and  are  represented 
as  defined  for  the  AP  Name  data  item. 


Data  Item  Name;  Binary/Native  Flag  Data  Item  ID:  BINNAT 

Data  Item  Description; 

Identifies  the  generic  type  of  data  contained  in  the  data 
portion  of  a  message.  Binary  indicates  that  the  data  is  in 
the  host  machine's  internal  representation  form  whereas 
native  indicates  that  the  data  is  character  data 
represented  by  the  host  machine's  character  code  (ASCII, 
EBCDIC,  etc.). 


Data  Item  Picture ;  X 
Coding  Type;  Alpha/Numeric 
Data  Item  Stability:  Dynamic 


Size  in  Bytes ;  1 

IDEFl  XRef :  EC  19 

Legal  Value  Set  By : 
User  (or  default) 


Where  Used;  Message  Header 

Value 

Legal  Values  Representation 

Binary  B 

Native  N 


Value  Definition 


Message  is  encoded 
in  binary  mode 

Message  is  encoded 
in  native  mode 
(default  value) 
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Data  Item  Name:  Channel  Range  End  Data  Item  ID:  CHANED 

Data  Item  Description: 

The  highest  Logical  Channel  ID  in  the  range  of  ID's 
allocated  to  a  user  at  logon.  This  item  is  reprsented 
a  logical  channel  ID.  It's  value  is  dynamic.  It  is  use 
as  a  field  in  the  Logon  Table. 


Data  Item  Name:  Child  Rank  Data  Item  ID:  RANK 

Data  Item  Description: 

A  numeric  ranking  assigned  to  the  child  AP  when  its  child 
table  entry  is  created.  The  rank  loosely  correlates  to 
the  order  in  which  the  child  AP's  are  spawned.  The  rank 
number  is  used  in  combination  with  the  Parent  AP  Name  as  a 
link  list  pointer  through  the  child  Table. 

Data  Item  Picture:  9(4)  Size  in  Bytes ;  4 

Coding  Type :  Numeric  IDEFl  XRef :  EC  51 

Data  Item  Stability:  Dynamic  Legal  Value  Set  By: 

User  (or  default) 

Where  Used:  Child  Table 


Value 

Legal  Values  Representation  Value  Definition 

0001-9999 


Data  Item  Name :  Channel  Range  Start  Data  Item  ID:  CHANST 

Data  Item  Description: 

The  lowest  Logical  Channel  ID  in  the  range  of  ID's 
allocated  to  a  user  at  Logon.  This  item  is  represented  as 
a  Logical  Channel  ID.  It's  value  is  dynamic.  The  item  is 
used  as  a  field  in  the  Logon  Table. 

Data  Item  Name :  Child  Status  Data  Item  ID;  CLDSTS 

Data  Item  Description : 

This  item  defines  the  current  operational  status  of  a 
given  child  AP.  The  status  values  provided  are  only  in 
terms  of  the  child's  relation  to  the  Parent  AP.  The 
status  of  the  child  AP  as  an  entity  unto  itself  is 
provided  in  the  AP  Status  Table. 


Data  Item  Picture :  X 
Coding  Type :  Alpha/Numeric 
Data  Item  Stability:  Dynamic 


Size  in  Bytes ;  1 

IDEFl  X  Ref . :  EC51 

Legal  Value  Set  By: 
Child  AP's  MPU 


Where  Used:  Child  Table 
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Values 

Abort-ACK 

N-Term-No-Cld 

SD-APC 

SD-AP 

SD-Host 

CLD-Initiated 


Value 

Representation 

1 

2 

3 

4 

5 

6 


Value  Definition 


Abort  Message  sent 
to  child  AP  has  been 
acknowledged 

Child  AP  has 
normally  terminated 
leaving  no  active 
children  of  its  own 

Child  AP  has  been 
shutdown  in  APC  SD 
Mode 

Child  AP  has  been 
shutdown  in  AP  SD 
mode 

Child  AP  has  been 
shutdown  in  Host  SD 
mode 

Child  AP  has  been 
initiated 


Legal  Values 


Value 

Representation 


Value  Definition 


Normal -Term-  7 

With-Child 


Child  AP  has 
normally 

terminated  leaving 
active  children 


Data  Item  Name;  Child  Table  Index  Data  Item  ID;  CLDIND 

Data  Item  Description; 

This  item  exists  in  the  AP  Status  Table  to  serve  as  an 
index  to  the  given  AP  Instance's  first  entry  in  the  child 
status  table.  It  is  a  dynamic  item  whose  values  are 
determined  when  the  Child  Table  entry  is  written.  It  is 
represented  in  COBOL  as  Pic  9(4). 

Data  Item  Name;  Children  Data  Item  ID;  CHLDRN 

Data  Item  Description; 

Identifies  whether  a  given  AP  has  any  child  AP's 
associated  with  it. 

Data  Item  Picture ;  X  Size  in  Bytes :  1 

Coding  Type;  Alpha/Numeric  IDEFl  XRef ;  EC  51 
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Data  Item  Stability:  Dynamic 


Legal  Value  Set  By : 
Local  MPU 


Where  Used:  AP  Status  Table 

Value 

Legal  Values  Representation 

No-Kids  0 


Kids 


1 


Value  Definition 

AP  has  no  associated 
child  AP's 

AP  has  associated 
child  AP's 


Data  Item  Name:  Continuation  Indicator  Data  Item  ID:  CONIND 


Data  Item  Description: 

This  Item  identifies  whether 
larger  group  of  messages. 

Data  Item  Picture:  X 

Coding  Type:  Alpha/Numeric 

Data  Item  Stability:  Dynamic 
AP  Interface 


a  given  message  is  part  of  a 

Size  in  Bytes :  1 
IDEFl  XRef :  EC  19 
Legal  Value  Set  By: 


Where  Used:  Message  Header 

Value 

Legal  Values  Representation 

First  Part  1 


Not  Continued  0 

Middle  Part  2 

Last  Part  3 


Value  Definition 


Message  is  the  first 
part  of  a  larger 
group  and  is 
continued 

Message  is  complete 
within  itself 

Message  is  somewhere 
in  the  middle  of  a 
continued  message. 

Message  is  the  last 
part  of  a  continued 
message . 


Data  Item  Name:  Data  Code  Data  Item  ID:  DATACD 

Data  Item  Description: 

This  Item  IS  used  in  the  I'M  Alive  Table  to  indicate 
whether  there  is  data  waiting  to  be  delivered  to  the  AP 
upon  the  MPU's  receipt  of  the  "I'm  Alive"  message.  This 
item  applies  to  messages  that  both  cause  an  initiation  to 
occur  and  carry  data. 
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Coding  Type:  Alpha/Numeric 
Data  Item  "Stability” :  Dynamic 


Where  Used:  I 'm 

Legal  Values 

No-Data 

Data-Waiting 

Data-In-Next- 

Msg 

Data  Item  Name: 


Alive  Table 
Value 

Representation 

1 

2 

3 

Data  Length 


Size  in  Bytes :  1 

IDEFl  X  Ref. ;  N/A 

Legal  Value  Set  By: 
Destination  MPU 


Value  Definition 


No  data  waiting 

Data  Waiting  in 
buffer 

Data  Arguments  are 
coming  in  another 
message 

Data  Item  ID:  DATLEN 


Data  Item  Description: 

This  field  exists  in  the  message  header  to  indicate  the 
length  of  the  actual  data  portion  of  the  message. 

Data  Item  Picture:  X(4)  Size  in  Bytes :  4 

Coding  Type:  Alpha/Numeric  IDEFl  XRef :  EC  19 

Data  Item  Stability:  Dynamic  Legal  Value  Set  By : 

Message  Source  AP 


Where  Used:  Message  Header 

Value  Range :  0000-9999 

Data  Item  Name :  Delay  Time  Trigger 


Data  Item  ID:  TRGTIM 


Data  Item  Description: 

The  trigger  time  represents  the  time  value  to  be  used  in 
conjunction  with  a  specified  delay  trigger  condition. 


Data  Item  Picture:  X(15) 
Coding  Type :  Alpha/Numeric 
Data  Item  Stability:  Dynamic 


Size  in  Bytes :  15 

IDEFl  XRef:  EC  19 

Legal  Value  Set  By : 
Source  AP  or  System 
Default 


Where  Used:  Message  Header 
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Representation:  System  Clock  Time 


Data  Item  Name:  Delay  Trigger 

Data  Item  Description: 

The  delay  trigger  indicates 
message  is  to  be  delivered. 

Data  Item  Picture:  X 

Coding  Type:  Alpha/Numeric 

Data  Item  Stability:  Dynamic 


Data  Item  ID:  DELTRG 

the  condition  under  which  the 

Size  in  Bytes :  1 

IDEFl  XRef :  EC  19 

Legal  Value  Set  By : 
Source  AP  or  System 
Default 


Where  Used:  Message  Header 

Value 

Legal  Values  Representation 

Deferred  Delay  1 


Conditional 


2 


Time-Triggered  3 

Immediate  0 

Data  Item  Name:  Delay  Trigger 

Condition 


Value  Definition 


Deliver  any  time 
after  a  specified 
time  (see  Delay  Time 
Trigger) 

Deliver  upon  a 
specified  condition 
or  event  (see  Delay 
Trigger  condition) 

Deliver  at  a 
specified  time 
(see  Delay  Time 
Trigger) 

Deliver  right  now 
(system  default) 

Data  Item  ID:  TRGCON 


Data  Item  Description: 

The  trigger  condition  specifies  the  actual  condition  under 
which  a  message  is  required  to  be  delivered. 


Data  Item  Picture;  X 
Coding  Type ;  Alpha/Numeric 
Data  Item  Stability:  Dynamic 


Size  in  Bytes ;  1 

IDEFl  XRef:  EC  19 

Legal  Value  Set  By : 
Source  AP  or  System 
Default 


Where  Used :  Message  Header 
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Value 

Legal  Values  Representation  Value  Definition 

TBD 


Data  Item  Name:  Guaranteed  Delivery 


Data  Item  ID:  GUARDL 


Data  Item  Description: 

This  item  indicates  whether  a  message  conforming  to  a 
given  category  requires  guaranteed  delivery  services. 
These  services  involve  a  concerted  effort  to  insure  the 
delivery  of  the  message  to  its  destination  AP. 

Data  Item  Picture:  X  Size  in  Bytes :  1 

Coding  Type:  Alpha/Numeric  IDEFl  XRef :  EC  36 

Data  Item  Stability:  Static  Legal  Value  Set  By: 

Message  Category 


Where  Used:  Message  Category  Table 

Value 

Legal  Values  Representation  Value  Definition 


GD 


1 


Message  Delivery  is 
Guaranteed 


No-GD 


0 


Message  Delivery  is 
not  Guaranteed 


Data  Item  Name:  Guaranteed  Delivery  Flag  Data  Item  ID:  GDFLAG 


Data  Item  Description; 

This  flag  IS  set  when  the  AP  instance  is  the  source  of  one 
or  more  guaranteed  delivery  messages  that  have  yet  to  be 
delivered.  Further  data  on  these  outstanding  guaranteed 
delivery  messages  is  maintained  in  the  guaranteed  delivery 
table. 


Data  Item  Picture;  X 
Coding  Type;  Alpha/Numeric 
Data  Item  Stability;  Dynamic 


Size  in  Bytes :  1 

IDEFl  XRef;  EC  16 

Legal  Value  Set  By: 
AP'S  MPU 


Where  Used:  AP  Status  Table 

Value 

Legal  Values  Representation  Value  Definition 

GD-Out  1  The  AP  instance  has 

guaranteed  messages 
outstanding-Flag  is 
set 
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No-GD  0  The  AP  instance  has 

no  gauranteed 
delivery  messages  - 
Flag  not  set 

Data  Item  Name:  Header  Format  Data  Item  ID:  HDRFMT 

Indicator 


Data  Item  Description: 

The  header  format  ID  identifies  the  particular  format  of 
the  given  message  header.  The  value  of  this  item  has  no 
relationship  to  the  data  portion  of  the  message. 

Data  Item  Picture:  X  Size  in  Bytes :  1 

Coding  Type:  Alpha/Numeric  IDEFl  XRef :  EC  19 

Data  Item  Stability:  Static  Legal  Value  Set  By: 

NTM  Developers 


Where  Used:  Message  Header 

Value 

Legal  Values  Representation 

A  A 

Data  Item  Name:  Header  Length 

Data  Item  Description: 

Specifies  the  length  (in  bytes) 
of  the  message. 

Data  Item  Picture:  X(3) 

Coding  Type ;  Alpha/Numeric 

Data  Item  Stability:  Static 


Value  Definition 
Header  Format  A 
Data  Item  ID:  HDRLEN 

of  the  NTM  header  portion 

Size  in  Bytes ;  3 

IDEFl  XRef:  EC  19 

Legal  Value  Set  By : 

NTM  Developers 


Where  Used:  Message  Header 

Value 

Legal  Values  Representation 

A-092  092 


Value  Definition 


The  length  of  Header 
Format  A 


Value  Range:  001-999 

Data  Item  Name:  Host  Statue  Data  Item  ID:  HSTSTS 

Data  Item  Description: 

The  host  status  identifies  the  current  operational  status 
of  a  given  physical  host  machine. 

Data  Item  Picture :  X  Size  in  Bytes :  1 
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IDEFl  XRef:  EC  1 


Legal  Value  Set  By: 
NTM 

Where  Used:  Host  Status  Table 


Value 

Legal  Values  Representation  Value  Definition 


Up 

1 

Machine 

is 

running 

Down 

0 

Machine 

is 

dead 

In-Start 

2 

Machine 

brought 

is 

up 

being 

In-Shutdown 

3 

Machine 

process 

down 

is 

of 

in  the 
shutting 

Data  Item  Name :  Initiation  Needs  Data  Item  ID: ININDS 

Data  Item  Description: 

Defines  whether  a  given  AP  requires  a  specific  initiation 
message  (Category  H)  in  order  to  be  started. 

Data  Item  Picture:  X  Size  in  Bytes :  1 

Coding  Type:  Alpha/Numeric  IDEFl  X  Ref . :  EC17 

Data  Item  Stability;  Static  Legal  Value  Set  By; 

AP  Developer 


Where  Used:  AP  Characteristics  Table 


Legal  Values 
No-Restric 

Needs-Init-Msg 

Start- From-Term 


Value 

Representation 

0 

1 

2 


Value  Definition 


AP  can  be  initiated 
by  any  message 

AP  requires  specific 
initiation  message 

AP  is  initiated  from 
a  terminal-not 
started  by  the 
NTM 


Data  Item  Name:  Instance  Data  Item  ID:  INSTNC 

Data  Item  Description: 

An  identifier  assigned  to  every  instance  (initiated 
occurrence)  of  a  given  AP.  The  instance  serves  to  uniquely 
identify  one  initiated  (awake)  AP.  In  the  case  of  the  User 
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Interface  AP,  the  instance  will  map  to  a  specific  terminal 
(or  screen,  in  multiscreen  mode) .  The  instance  identifier 
is  associated  with  an  AP  from  its  initiation  until  the  AP 
and  its  associated  instaces  are  cleaned  up. 

Data  Item  Picture :  X(2)  Size  in  Bytes :  2 

Coding  Type ;  Alpha/Numeric  IDEFl  XRef ;  EC  16 

Data  Item  Stability:  Dynamic  Legal  Value  Set  By: 

Local  MPU 


Where  Used:  AP  Status  Table;  Message  Header;  I'm  Alive  Table 
Value  Range ;  01-99 

Data  Item  Name :  Instances  Currently  Data  Item  ID:  NUMINS 

Running 

Data  Item  Description; 

This  data  item  identifies  the  number  of  instances  of  a 
given  AP  which  are  currently  in  some  stage  of  operation. 


Data  Item  Picture:  X(2) 
Coding  Type:  Alpha/Numeric 
Data  Item  Stability;  Dynamic 


Size  in  Bytes :  2 

IDEFl  XRef;  EC  16 

Legal  Value  Set  By ; 
Local  MPU 


Where  Used;  AP  Operating  Information  Table 
Value  Range ;  00-36 

Data  Item  Name;  Integrity  Check  Flag  Data  Item  ID;  INTCHK 

Data  Item  Description : 

Indicates  whether  the  data  portion  of  a  given  message 
should  be  validated  against  the  data  format  specified  in 
the  message  header. 


Data  Item  Picture:  X 
Coding  Type :  Alpha/Numeric 
Data  Item  Stability:  Dynamic 

Where  Used ;  Message  Header 


Legal  Values 
Check 


Value 

Representation 


Size  in  Bytes ;  1 

IDEFl  XRef :  EC  19 

Legal  Value  Set  By : 
Source  AP  or  System 
Default 


Value  Definition 

Data  portion  is  to 
be  checked  for  data 
integrity 
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Data  portion  is  not 
to  be  checked 

Data  Item  ID:  LSTINS 


Data  Item  Description: 

This  item  provides  the  value  of  the  last  instance  number 
assigned  to  an  instance  of  a  given  AP. 


Data  Item  Picture :  X(2) 


Codinc 


Alpha/Numeric 


Data  Item  Stability :  Dynamic 


Size  in  Bytes :  2 

IDEFl  XRef :  EC  17 

Legal  Value  Set  By : 
MPU 


Where  Used:  AP  Operating  Information  Table 


Value  Range:  01-99 


Data  Item  Name :  Last  Key  Pointer 


Data  Item  ID:  LSTKEY 


Data  Item  Description: 

Pointer  to  the  last  key  value  assigned  for  a  given  AP  for 
messages  queued  in  the  AP  queue. 


Data  Item  Picture ;  X(9) 


Codinc 


Alpha/Numeric 


Data  Item  Stability ;  Dynamic 


Where  Used:  AP  Status  Table 


Data  Item  Name:  Link  ID 


Size  in  Bytes :  9 

IDEFl  XRef:  EC  16 

Legal  Value  Set  By ; 
MPU 


Data  Item  ID:  LINKID 


Data  Item  Description: 

The  identification  of  a  specific  communications  link 
between  two  physical  host  machines.  The  link  is  maintained 
by  "sibling"  COMM  AP's. 


Data  Item  Picture :  X(2) 


Codinc 


:j_  Alpha/Nunieric 


Data  Item  Stability:  Static 


Where  Used:  Link  Status  Table 


Legal  Values 


Value 

Representation 


Size  in  Bytes :  2 

IDEFl  XRef;  EC  48 

Legal  Value  Set  By : 
NTM  Developers 


Value  Definition 
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VAX -IBM 


VI 


Link  between  the  VAX 
11/780  and  the  IBM 
4381 


Data  Item  Name ;  Link  Status 

Data  Item  Description; 

The  current  operational 

Data  Item  Picture:  X 

Coding  Type:  Alpha/Numeric 

Data  Item  Stability:  Dynamic 


Data  Item  ID;  LKLSTAT 

of  a  given  link. 

Size  in  Bytes :  1 

IDEFl  X  Ref.  :  EC48 

Legal  Value  Set  By: 

VAX  Monitor  AP 


Where  Used:  Link  Status  Table 


Legal  Values 


Value 

Representation 


Active 


1 


Inactive 


0 


Started 


2 

has  been  sent-no 
return  yet 


Value  Definition 
Link  is  Active 
Link  has  failed 
Start  Link  message 


Data  Item  Name ;  Log  Requirement  Data  Item  ID;  LOGREQ 

Data  Item  Description: 

The  log  requirement  identifies  whether  a  message  is  to  be 
logged  based  upon  the  given  message  category.  In  the  Test 
Bed  all  messages  will  be  logged.  For  future  releases, 
logging  will  be  restricted  to  certain  message  categories 
in  accordance  with  the  requirements  defined  by  the 
recovery  function. 

Data  Item  Picture:  X  Size  in  Bytes :  1 

Coding  Type :  Alpha/Numeric  IDEFl  XRef :  EC  36 

Data  Item  Stability;  Static  Legal  Value  Set  By : 

Message  Category 


Where  Used:  Message  Category  Table 

Value 

Legal  Values  Representation  Value  Definition 


Yes 

No 


1 

0 

message 


Log  the  Message 
Don't  log  the 
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Data  Item  Name;  Logical  Channel  ID 


Data  Item  ID:  CHANID 


Data  Item  Description; 

This  item  identifies  a  logical  connection  between  two  or 
more  awake  APs.  This  connection  is  established  in  two 
cases.  The  first  case  involves  the  maintenance  of  a 
"family  tree"  of  AP  instances.  The  second  case  serves  to 
identify  a  unigue  pair  of  messages. 


Data  Item  Picture :  X(3) 


Codinc 


^  Alpha/Numeric 


Data  Item  Stability:  Dynamic 


Size  in  Bytes :  3 

IDEFl  XRef :  EC  50 

Lec^al  Value  Set  By : 
Original  Source  AP 
AP  Interface  (for 
default) 


Where  Used:  Message  Header;  Message  Pairing  Table;  AP  Status 
Table;  Child  Status  Table. 

Representation :  Any  combination  of  3  Alpha  or  Numeric 

characters . 


Data  Item  Name;  Logical  Host  Name 


Data  Item  ID:  HSTNAM 


Data  Item  Description; 

Host  name  identifies  an  instance  of  a  logical  host  within 
a  physical  host  machine  on  the  IISS.  The  logical  host  has 
a  number  of  AP  Clusters  assigned  to  it. 


Data  Item  Picture;  X(3) 


Codinc 


Alpha/Numeric 


Data  Item  Stability:  Static 


Size  in  Bytes:  3 


IDEFl  XRef:  EC  41 


Legal  Value  Set  By : 


Where  Used:  Host  Status  Table;  AP  Cluster  Status  Table 


Data  Item  Name:  Maximum  Instances 


Data  Item  ID:  MAXINS 


Data  Item  Description: 

This  Item  defines  the  maximum  number  of  instances  of  a 
given  AP  that  can  be  initiated  at  any  given  time. 


Data  Item  Picture ;  X(2) 


Codinc 


^  Alpha/Numeric 


Data  Item  Stability:  Static 


Where  Used:  AP  Characteristics  Table 


Size  in  Bytes:  2 


IDEFl  XRef:  EC  17 


Legal  Value  Set  By : 


Data  Item  Name :  Maximum  Number  of 

Queued  Messages 


Data  Item  ID:  NOAMSG 
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Data  Item  Description: 

This  item  identifies  the  maximum  number  of  messages  that 
are  allowed  to  be  in  a  given  (generic)  AP's  queue  at  any 
one  time. 


Data  Item  Picture :  X(2) 

Coding  Type :  Alpha/Numeric 
Data  Item  Stability;  Static 

Where  Used:  AP  Characteristics  Table 


Size  in  Bytes ;  2 

IDEFl  X  Ref. :  EC17 

Legal  Value  Set  By : 
AP  Developer 


Value  Range :  00-99 

Data  Item  Name:  Message  Category  Data  Item  ID;  MSGCAT 

Data  Item  Description: 

The  message  category  defines  processing  reguired  by  the 
message.  The  category  implies  the  level  of  processing 
needed  to  establish  the  overall  acceptability  of  the 
message.  It  also  specifies  certain  special  services  the 
NTM  is  required  to  provide. 


Data  Item  Picture;  X  Size  in  Bytes ;  1 

Coding  Type:  Alpha  IDEFl  XRef :  EC  36 

Data  Item  Stability;  Static  Legal  Value  Set  By; 

NTM  Developers 


Where  Used:  Message  Header;  Message  Category  Table 

Value 

Legal  Values  Representation  Value  Definition 


Guar-Del  A 

Resp-Reqd  B 

SysComd-No  Resp  C 

Syscomd-Resp  D 

Unsol-Msg  E 

Sol-Msg  F 

ApStatus-Msg  G 


Message  requires  a 
Guaranteed  Delivery 
Service 

Response  Required 

System  Command  -  No 
Response  Required 

System  Command  - 
Response  Required 

Unsolicited  Message 

Solicited  Message 

AP  Status  Message 
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Init-Msg-No-  H 

Response 


Message  specifically 
requires  the 
initiation  of  an  AP 
Instance 


Legal  Values 


Value 

Representation 


Value  Definition 


Msg-From-COMM  I 


Message  having  a 
COMM  AP  as  its 
source 


Init-Msg-Response-  J  Paired  Specific 

Required  initiation 

message 

Data  Item  Name :  Message  Destination  Data  Item  ID:  MSGDST 

Data  Item  Description: 

The  Application  Process  that  is  the  receiver  of  the  given 
message.  The  destination  is  defined  as  the  combination  of 
the  receiving  AP  name,  instance  (if  known),  and  resident 
AP  Cluster.  It  is  represented  in  the  message  header  as: 

10  HDR  MSGDST 

15  MD  APNAME  X(10) 

15  MD  INSTNC  X(2) 

15  MD  APCNME  X(3) 

This  item  is  used  in  the  Guaranteed  Delivery  table  to  identify 
the  destination  of  a  given  GD  message. 


Data  Item  Name;  Message  Log  Time  Stamp  Data  Item  ID:  TSTAMP 
Data  Item  Description: 

The  host  system  clock  time  at  the  occurrence  of  a 
particular  event. 


Data  Item  Picture;  X ( 2 3 ) 
Coding  Type:  Alpha/Numeric 
Data  Item  Stability:  Dynamic 


Size  in  Bytes :  23 

IDEFl  XRef :  N/A 

Legal  Value  Set  By: 
Host  OS 


Where  Used:  Message  and  Error  Log 

Data  Item  Name:  Message  Priority  Data  Item  ID:  MSGPRY 

Data  Item  Description: 

The  priority  code  identifies  the  processing  priority 
assigned  to  a  message  conforming  to  a  given  message 
category. 


Data  Item  Picture;  X  Size  in  Bytes :  1 

Coding  Type ;  Alpha/Numeric  IDEFl  XRe f :  EC  36 
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Data  Item  Stability:  Static 


Legal  Value  Set  By : 
Message  Category 


Where  Used:  Message  Header;  Message  Category  Table 


Legal  Values 


Value 

Representation 


Value  Definition 


Cold 


Data  Item  Name:  Message  Queue  Flag 


Message  has  high 
priority 

Message  has  low 
priority 

Data  Item  ID;  MSGQUF 


Data  Item  Description: 

This  item  IS  a  flag  that  is  set  when  there  are  messages  in 
queue  waiting  for  a  specified  AP  Instance. 


Data  Item  Picture:  X 


Codinc 


Alpha/Numeric 


Data  Item  Stability;  Dynamic 


Where  Used:  AP  Status  Table 


Legal  Values 


Msg-In 


Value 

Representation 


No-Msg 


Data  Item  Name ;  Message  in  Queue 


Size  in  Bytes :  1 

IDEFl  XRef :  EC  16 

Legal  Value  Set  By: 
Local  MPU 


Value  Definition 

There  are  messages 
in  the  queue  for  the 
AP  Instance  -  Flag 
is  set 

There  are  no 
messages  in  the 
queue  -  No  flag 

Data  Item  ID:  NMSG 


Data  Item  Description; 

Identifies  the  number  of  messages  currently  queued  for  a 
given  AP  instance. 


Data  Item  Picture :  X(4) 


Codinc 


Alpha/Numeric 


Data  Item  Stability :  Dynamic 


Where  Used;  AP  Status  Table 


Size  in  Bytes:  4 


IDEFl  XRef:  EC  16 

Legal  Value  Set  By: 
Local  MPU 


Data  Item  Name :  Message  Serial  Number  Data  I  tern  ID:  MSGSN 
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Data  Item  Description: 

A  number  that  is  assigned  to  each  message  by  its  source 
MPU  AP  Cluster.  The  number  itself  is  unique  only  within  an 
AP  Cluster.  In  order  for  the  message  to  be  uniquely 
identifiable  within  the  IISS,  the  serial  number  is 
concatenated  with  the  source  AP  Cluster  name. 

Data  Item  Picture:  X(7)  Size  in  Bytes :  7 

Coding  Type:  Alpha/Numeric  IDEFl  XRef :  EC  19 

Data  Item  Stability:  Dynamic  Legal  Value  Set  By : 

Source  MPU 

Where  Used:  Message  Header;  Guaranteed  Delivery  Table 

Data  Item  Name:  Message  Serial  Number  Data  Item  ID:  SERNLQ 

Last  Queued 

Data  Item  Description: 

The  serial  number  and  source  AP  Cluster  of  the  last 
message  written  to  the  message  queue  for  a  given  AP 
instance.  The  value  representation  is  taken  from  the 
header  of  the  message. 

This  data  item  is  maintained  for  recovery  processing 
purposes . 

Data  Item  Picture:  X(10) 

Coding  Type:  Alpha/Numeric 
Data  Item  Stability:  Dynamic 


Where  Used:  AP  Status  Table 

Data  Item  Name :  Message  Source 

Data  Item  Description: 

The  Application  Process  that  is  the  immediate  sender  of  a 
given  message.  The  source  is  defined  as  the  combination  of 
the  sending  AP's  name,  instance,  and  resident  AP  Cluster. 
It  is  represented  in  the  message  header  as: 

10  HDR  MSGSRC 

15  MS  APNAME  PIC  X(10) 

15  MS  INSTNC  PIC  X(2) 

15  MS  APCNME  PIC  X(3) 

This  item  is  used  in  the  Guaranteed  Delivery  table  to  identify 
the  source  of  the  given  GD  message. 

Data  Item  Name :  Message  Type  Data  Item  ID:  MSGTYP 


Size  in  Bytes :  10 

IDEFl  XRef:  EC  16 

Legal  Value  Set  By: 
Local  MPU 

Data  Item  ID:  MSGSRC 
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Data  Item  Description: 

The  message  type  represents  the  nature  of  a  given  message. 
It  is  used  for  authorization  purposes  where  the  type  is 
matched  to  a  specified  path  (source  to  destination) ,  The 
message  type  is  also  used  to  specify  the  format  of  the 
data  portion  of  the  message. 

Data  Item  Picture:  X(2)  Size  in  Bytes :  2 

Coding  Type :  Alpha  IDEFl  X  Ref . :  EC5 

Data  Item  Stability:  Static  Legal  Value  Set  By : 

Message  Source  AP 

Where  Used:  Message  Header;  Authority  Table 

Value 

Legal  Values  Representation  Value  Definition 

See  Appendix  E  for  the  definition  of  Message  Types  within  the 
NTM. 

Data  Item  Name :  Next  Sibling  Index  Data  Item  ID:  NXTSIB 


Data  Item  Description: 

This  field  is  used  in  the  child  status  table  as  a  pointer 
between  one  child  AP  and  it's  next  sibling  (i.e.,  next 
child  spawned  by  the  same  Parent  AP) .  This  is  a  dynamic 
item  whose  values  are  determined  by  the  Child  Table  rank 
assignment  protocols. 

Data  Item  Name:  Number  of  Connections  Data  Item  ID:  NOCONN 


Data  Item  Description: 

Where  the  AP  instance  is  of  the  Queue  Server  Type,  this 
item  provides  the  number  of  sources  that  are  connected  to 
it  at  any  one  time. 

Data  Item  Picture:  X(2) 


Coding  Type :  Alpha/Numeric 
Data  Item  Stability:  Dynamic 


Where  Used :  AP  Status  Table 
Value  Range :  00-99 
Data  Item  Name :  Number  of  Mailboxes  Data  J tern  ID:  NUMMBX 

Data  Item  Description : 

Defines  the  number  of  mailboxes  a  given  AP  will  support. 
An  AP  that  needs  no  input  will  not  support  any  mailboxes. 
AP's  that  accept  input  will  support  either  one  mailbox  or 
two.  The  second  mailbox  is  used  by  AP's  having  the 
capability  of  receiving  unsolicited  messages. 


Size  in  Bytes :  2 

IDEFl  XRef ;  EC  16 

Legal  Value  Set  By: 
Local  MPU 


D-27 


DS  620342000 
30  September  1990 


Data  Item  Picture;  X 
Coding  Type:  Alpha/Numeric 
Data  Item  Stability:  Static 

Where  Used;  AP  Characteristics 


Size  in  Bytes ;  1 

IDEFl  X  Ref. :  EC17 

Legal  Value  Set  By; 
AP  Developer 

Table 


Legal  Values 
No-MBX 


Value 

Representation 

0 


Value  Definition 
AP  has  no  mailboxes 


One-MBX 


1 


Two-MBX 


2 


AP  supports  one 
mailbox  (and  a 
small  "ACK"  mailbox) 

AP  supports  two 
mailboxes  and 
is  able  to  receive 
unsolicited  messages 
(the  AP  also 
supports  a  small 
"ACK"  mailbox) 


Data  Item  Name;  Number  of  Messages  Data  Item  ID;  NUMMSG 

Data  Item  Description; 

This  Item  value  provides  the  number  of  messages  in  queue 
waiting  for  a  given  generic  Application  Process  (not 
instance) . 


Data  Item  Picture;  X(2) 
Coding  Type :  Alpha/Numeric 
Data  Item  Stability:  Dynamic 


Size  in  Bytes :  2 

IDEFl  XRef :  EC  17 

Legal  Value  Set  By ; 
Local  MPU 


Where  Used;  AP  Operating  Information  Table 

Data  Item  Name:  Number  of  Parents  Data  Item  ID;  NOPINS 

Per  Instance 

Data  Item  Description: 

Defines  the  number  of  "Parents"  a  given  AP  instance  may 
have  at  any  one  time.  This  item  distinguishes  between  a 
single  instance  type  of  AP  (one  parent  per  instance)  and  a 
queue  server  type  of  AP  (multiple  parents  per  instance) . 

In  the  case  of  a  queue  server  this  item  also  serves  to 
define  the  maximum  number  of  sources  that  can  be  connected 
to  it  at  any  one  time. 

Data  Item  Picture :  X(2)  Size  in  Bytes ;  2 
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Coding  Type:  Alpha/Numeric 
Data  Item  Stability:  Static 


IDEFl  X  Ref. :  EC17 

Legal  Value  Set  By: 
AP  Developer 


Where  Used:  AP  Characteristics  Table 


Value  Range:  01-99 


Data  Item  Name:  Number  of  Tries 


Data  Item  ID:  NTRIES 


Data  Item  Description: 

Identifies  the  number  of  times  an  entry  in  the  I'm  Alive 
table  has  been  checked.  After  a  given  number  of  checks 
without  receiving  an  I'm  Alive  message  from  the  AP,  it 
must  be  asssumed  that  the  AP  is  in  trouble.  The  MPU  will 
then  take  appropriate  action. 


Data  Item  Picture:  X 


Codinc 


‘■j_  Alpha/Numeric 


Data  Item  Stability:  Dynamic 


Where  Used:  I'm  Alive  Table 


Size  in  Bytes :  1 

IDEFl  X  Ref. :  N/A 

Legal  Value  Set  By: 
NTM  Developers 


Data  Item  Name:  On  Abort 


Data  Item  ID:  ONABT 


Data  Item  Description: 

This  item  defines  how  a  given  generic  AP  is  to  be  handled 
when  an  abort  message  arrives  for  it. 


Data  Item  Picture:  X 
Coding  Type:  Alpha/Numeric 
Data  Item  Stability:  Static 


Size  in  Bytes :  1 

IDEFl  XRef :  EC  17 

Legal  Value  Set  By : 
AP  Developer 


Where  Used:  AP  Characteristics  Table 


Legal  Values 


Value 

Representation 


Value  Definition 


Run-Comp 

Send-Abort 


Ab-Term 


Run  to  completion 

Forward  the  abort 
message  to  the  AP. 

Abnormally  terminate 
the  AP  via  an  OS 
Call 


Data  Item  Name :  On-Child  Abnormal 

Termination 


Data  Item  ID: 
ONCLDA 
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Data  Item  Description: 

This  item  IS  used  to  indicate  whether  a  given  AP  requires 
a  status  message  upon  the  abnormal  termination  (abort)  of 
one  of  its  child  AP's.  It  further  indicates  whether  the 
given  AP  is  to  be  abnormally  terminated  itself  upon  a 
child  abort. 

Data  Item  Picture:  X  Size  in  Bytes ;  1 

Coding  Type:  Alpha/Numeric  IDEFl  XRef :  EC  17 

Data  Item  Stability:  Static  Legal  Value  Set  By : 

AP  Developer 


Where  Used:  AP  Characteristics  Table 


Legal  Values 

Value 

Representation 

Value  Definition 

No-Send-Msg 

0 

No  message  to  AP-MPU 
status  message  only 

Send-Msg 

1 

AP  wants  child 
abnormal  termination 
message 

Abort 

2 

Abort  Parent  on 

Child  Abort 

Data  Item  Name: 

On-Child  Normal 
Termination 

Data  Item  ID:0NCLDT 

Data  Item  Description: 

This  item  is  used  to  indicate  whether  a  given  AP  requires 
a  status  message  upon  the  normal  termination  of  one  of  its 
child  AP's.  It  further  indicates  whether  the  given  AP 
should  be  terminated  itself  upon  its  child  normal 
termination. 

Data  Item  Picture:  X 

Size  in  Bytes:  1 

Coding  Type:  Alpha/Numeric 

IDEFl  XRef:  EC  17 

Data  Item  Stability:  Static 

Legal  Value  Set  By: 

AP  Developer 

Where  Used:  AP 

Characteristics  Table 

Legal  Values 

Value 

Representation 

Value  Definition 

No-Msg 

only 

0 

No  message  to  AP-MPU 

Reg  Msg 
termination 

1 

AP  wants  child 
message 
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Kill-Parent 


2 


Terminate  Parent 
upon  Child's 
normal  termination 


Data  Item  Name:  On-Child  Shutdown  Data  Item  ID:  ONCLDS 

Data  Item  Description: 

Indicates  whether  a  given  AP  requires  a  status  message 
upon  the  shutdown  of  one  of  it's  child  AP's,  It  further 
indicates  whether  the  Parent  AP  should  abort  upon  the 
Child  AP  shutdown. 


Data  Item  Picture:  X  Size  in  Bytes :  1 

Coding  Type :  Alpha/Numeric  IDEFI  XRef :  EC  17 

Data  Item  Stability:  Static  Legal  Value  Set  By : 

AP  Developer 


Where  Used:  AP  Characteristics  Table 

Value 

Legal  Values  Representation 

Msg-No  0 


Msg-Yes  1 

Abort-Parent  2 


Value  Definition 


No  message  to  Parent 
AP 

Parent  AP  wants  a 
message 

Abort  the  Parent  on 
Child  AP  Shutdown 


Data  Item  Name:  On-Recovery  Data  Item  ID:  ONREC 

Data  Item  Description: 

Indicates  whether  a  given  AP  contains  the  internal  logic 
to  process  startup  in  a  recovery  mode  as  well  as  in  an 
initiate  mode. 

Data  Item  Picture :  X  Size  in  Bytes :  1 

Coding  Type :  Alpha/Numeric  IDEFI  XRef :  EC  17 

Data  Item  Stability:  Static  Legal  Value  Set  By ; 

AP  Developer 


Where  Used :  AP  Characteristics  Table 

Value 

Legal  Values  Representation  Value  Definition 

Can-Handle  1  AP  can  >^iandle  its 

own  Recovery 
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Can ' t-Handle 


AP  cannot  handle  its 
own  Recovery 


Data  Item  Name:  On  Shutdown 


Data  Item  ID:  ONSTDN 


Data  Item  Description: 

Indicates  whether  the  given  AP  contains  internal  logic  to 
process  a  shutdown  message  from  the  NTM. 


Data  Item  Picture:  X 
Coding  Type :  Alpha/Numeric 
Data  Item  Stability :  Static 

Where  Used:  AP  Characteristics  Table 


Legal  Values 

Has-Logic 
own  shutdown 

No-Logic 

Run-to-Comp 


Value 

Representation 


Data  Item  Name :  Original  Source  AP 


Size  in  Bytes :  1 

IDEFl  XRef :  EC  17 

Legal  Value  Set  By: 
AP  Developer 


Value  Definition 
AP  can  handle  its 


AP  cannot  handle  its 
own  shutdown 

AP  is  shutdown  from 
a  source  other  than 
the  MPU  -  it  should 
not  be  sent  a 
shutdown  message 
nor  should  it  be 
aborted . 

Data  Item  ID:  ORGSRC 


Data  Item  Description: 

The  original  source  of  the  message  that  initiated  the 
"head"  AP  of  a  given  tree  of  AP's.  The  source  is 
identified  by  its  AP  Name,  Instance,  and  resident  AP 
Cluster.  Its  value  representation  is  taken  from  the 
Message  Source  Header  field  of  the  original  message. 


Data  Item  Picture:  X(15) 
Coding  Type :  Alpha/Numeric 
Data  Item  Stability:  Dynamic 


Size  in  Bytes :  15 

IDEFl  XRef:  EC  42 

Legal  Value  Set  By : 
MPU 


Where  Used :  Message  Header;  AP  Status  Table;  Message  Pairing 
Table 

Representation : 
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01  Original-Source 

03  Original-Source-AP  PICK (10). 

03  Original-Source-Instance  PICX(2). 


03  Originai-Source-APC 

Data  Item  Name :  Pair  Flag 

Data  Item  Description; 

The  pair  flag  is  set  when 

more  outstanding  waits  on 

Data  Item  Picture :  X 

Coding  Type ;  Alpha/Numeric 

Data  Item  Stability ;  Dynamic 

Where  Used :  AP  Status  Table 

Value 

Legal  Values  Representation 

Pair-Set  1 

No-Pair  0 


PICX(3)  . 

Data  Item  ID:  PRFLAG 


a  given  AP  Instance  has  one  or 
paired  messages. 

Size  in  Bytes :  1 

IDEFl  XRef :  EC  16 

Legal  Value  Set  By: 
Local  MPU 


Value  Definition 

AP  Instance  has  one 
or  more  oustanding 
waits  -  Flag  is  set 

AP  Instance  has  no 
paired  messages  - 
Flag  not  set 


Data  Item  Name :  Pairing  Requirement  Data  Item  ID;  PREQMT 

Data  Item  Description; 

The  pairing  requirement  indicates  whether  the  message 
conforming  to  a  given  category  will  require  pairing 
services.  These  services  involve  creating  an  entry  into 
the  Message  Pair  Table,  tracking  timeouts  on  a  pair,  and 
matching  the  response  message  to  its  request. 

Data  Item  Picture :  X  iH  Bytes :  1 

Coding  Type ;  Alpha/Numeric  IDEFl  XRef :  EC  36 

Data  Item  Stability ;  Static  Legal  Value  Set  By : 

Message  Category 


Where  Used :  Message  Category  Table 


Value 

Legal  Values  Representation 


Value  Definition 


Pair  1 

N  o  -  Pa  i  r  0 


Message 
pa i ring 

M  e  s  s  a  g  a 
requ i re 


requ ires 

does  not 
pair'!  ng 
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Data  Item  Name:  Physical  Host  Name  Data  Item  ID:  PHYHST 

Data  Item  Description : 

A  physical  host  machine  is  an  actual  instance  of  a 
computer.  The  physical  host  is  referenced  as  one  or  more 
logical  host{s)  (see  Logical  Host  Name), 

Data  Item  Picture :  X(3)  Size  in  Bytes :  3 

Coding  Type :  Alpha/Numeric  IDEFl  XRef :  EC  1 

Data  Item  Stability:  Static  Legal  Value  Set  By : 

Host  Vendor 


Where  Used :  Host  Status  Table 

Value 

Legal  Values  Representation 

VAX  VAX 

IBM  IBM 


Value  Definition 
VAX  11/780 
IBM  4381 


Data  Item  Name :  Process  Nam.e 

Data  Item  Description : 

The  name  and  instance  identi 

Data  Item  Picture :  X(12) 

Coding  Type :  Alpha/Numeric 

Data  Item  Stability :  Dynamic 


Data  Item  ID:  PRONME 

ier  of  an  alive  AP. 

Size  in  Bytes :  12 

IDEFl  X  Ref. :  EC  16 

Legal  Value  Set  By : 

AP  Interface 


Where  Used :  Message  Header,  AP  Status  Table,  I'm  Alive  Table 
Representation : 


01  Process-Name 

03  AP-Name  PICX(IO). 

03  AP-Instance  PICX(2). 

Data  Item  Name :  Processing  Code  Data  Item  ID:  PROCDE 

Data  Item  Description: 

When  a  message  is  accepted  by  an  MPU,  an  accept  message. 
(Message  Manager  ACK-type  MA)  is  sent  to  the  message 
source  AP,  In  the  data  portion  of  this  message,  the 
entire  header  of  the  accepted  message  is  returned.  The  AP 
Interface  may  retain  this  header  for  use  on  future 
identical  messages.  Where  the  header  is  reused,  the  AP 
Interface  sets  the  Processing  Code  field  value  in  the 
header  to  "1"  (used).  The  MPU  can  then  bypass  the  normal 
data  integrity  checks  on  the  message  header. 
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Data  Item  Picture :  X 

Coding  Type:  Alpha/Numeric 

Data  Item  Stability:  Dynamic 
AP  Interface 


Size  in  Bytes :  1 
IDEFl  X  Ref. ;  N/A 
Legal  Value  Set  By : 


Where  Used :  Message  Header 

Value 

Legal  Values  Representation 

Used  1 

New  0 

Data  Item  Name:  Pseudo  Instance 


Value  Definition 


Message  header  has 
been  used  previously 
and  is  acceptable 

Message  header  has 
never  been  checked 
by  the  MPU  (default 
value) 

Data  Item  ID:  PINSTNC 


Data  Item  Description: 

An  identifier  assigned  to  each  "connection"  of  a  Queue 
Server  AP  requiring  message  chaining.  In  effect  this  item 
identifies  an  instance  within  an  instance  for  those  AP's 
that  deal  with  multiple  "Parents"  concurrently. 

Data  Item  Picture:  X  Size  in  Bytes ;  1 

Coding  Type :  Alpha/Numeric  IDEF]  X  Ref . :  53 

Data  Item  Stability:  Dynamic  Legal  Value  Set  By : 

Where  Used:  Connection  Table 


Value 

Legal  Values  Representation  Value  Definition 

0-Z 


Data  Item  Name :  Queue  Server  Type 

Data  Item  Description : 

Identifies  the  chaining  support 

Data  Item  Picture:  X 

Coding  Type :  Alpha/Numeric 

Data  Item  Stability:  Static 


Data  Item  ID:  ASTYPE 

required  by  the  AP. 

Size  in  Bytes :  1 

IDEFl  X  Ref.  :  17 

Legal  Value  Set  By : 
AP  Developer 


Where  Used :  AP  Information  Table 

Value 

Legal  Values  Representation  Value  Definition 
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No  Chain 
Child-Chain 

Message-Chain 

Data  Item  Name :  Role  Name 

Data  Item  Description: 

The  role  name  identifies  a 
within  the  IISS.  Each  user 
to  one  or  more  roles. 

Data  Item  Picture:  X(10) 

Coding  Type:  Alpha/Numeric 

Data  Item  Stability:  Static 


The  AP  requires  no 
chaining  support. 

The  NTM  will  build  a 
child  AP  chain  of 
any  AP's  spawned. 

The  NTM  will  build  a 
message  or 
"connection"  chain 
for  the  AP. 

Data  Item  ID:  ROLENM 


generic  class  of  human  users 
on  the  system  may  be  assigned 


Size  in  Bytes :  10 

IDEFl  XRef :  EC  12 

Legal  Value  Set  By: 
Subsystem  Developer 


Where  Used:  Logon  Table 

Data  Item  Name:  Session  Start  Time 


Data  Item  ID:  STRTME 


Data  Item  Description: 

The  system  clock  time  when  an  IISS  user's  logon  request 
was  accepted. 


Data  Item  Picture:  X(23) 
Coding  Type:  Alpha/Numeric 
Data  Item  Stability:  Dynamic 


Size  in  Bytes :  23 

IDEFl  XRef:  EC  12 

Legal  Value  Set  By: 
UI 


Where  Used:  Logon  Table 

Data  Item  Name :  Statistics  Collection  Data  Item  ID;  STATCO 

Flag 

Data  Item  Description: 

The  statistics  collection  flag  indicates  whether  certain 
statistical  data  is  to  be  collected  on  the  given  message. 

Data  Item  Picture :  X  Size  in  Bytes :  1 

Coding  Type :  Alpha/Numeric  IDEFl  XRef ;  EC  36 

Data  Item  Stability :  Static 
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Where  Used;  Message  Header;  Message  Category  Table 

Value 

Legal  Values  Representation  Value  Definition 


Collect  1 

No-Collect  0 


Data  Item  Name:  Terminal  ID 


Collect  statistics 
on  this  message 

Don't  collect 
statistics  on 
this  message 
Data  Item  ID:  TERMID 


Data  Item  Description; 

A  physical  instance  of  a  computer 

Data  Item  Picture ;  X(2) 

Coding  Type :  Alpha/Numeric 

Data  Item  Stability:  Static 


terminal  on  the  IISS. 

Size  in  Bytes :  2 

IDEFl  XRef ;  EC  7 

Legal  Value  Set  By: 
UI 


Where  Used;  Logon  Table 


Data  Item  Name;  Test  Flag  Data  Item  ID;  TSTFLG 

Data  Item  Description; 

This”  flag  exists  in  the  message  header  to  indicate  whether 
the  source  AP  of  the  given  message  is  operating  in  test 
mode.  This  flag  serves  as  a  warning  to  the  destination  AP 
to  process  the  message  accordingly  (i.e.,  no  update 
processing  on  a  message  with  the  test  flag  set  to  "1"). 

Data  Item  Picture ;  X  size  in  Bytes ;  1 

Coding  Type :  Alpha/Numeric  IDEFl  XRef:  EC  19 


Data  Item  Stability:  Dynamic 


Legal  Value  Set  By : 
Source  AP  or  System 
Default 


Where  Used :  Message  Header 


Legal  Values 
In-Test 

No-Test 

Data  Item  Name: 


Value 

Representation 

1 

0 

Timeout  Handling 


Value  Definition 


Source  AP  is 
operating  in  test 
mode 

Source  AP  is 
operating  in 
normal  mode 
Data  Item  ID:  TMOI.DL 
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Data  Item  Description; 

Identifies  how  a  given  AP  is  to  be  handled  in  the  event 
that  a  timeout  on  a  paired  message  expires  before  the 
reply  message  arrives. 

Data  Item  Picture :  X  Size  in  Bytes ;  1 

Coding  Type :  Alpha/Numeric  IDEFl  X  Ref . ;  EC17 


Data  Item  Stability;  Static 

Where  Used;  AP  Characteristics  Table 

Value 

Legal  Value  Set  By: 

AP  Developer 

Legal  Values 

Representation 

Value  Definition 

No-Can-do-Pairs 

0 

AP  does  not  send 

Paired  Messages 

Cancel-Pair 

1 

Delete  entry  in  Pair 

Table 

Abort-on- 

Timeout 

2 

Abort  AP  when 
timeout  expires 
before  reply  arrives 

No-Cancel -Pair 

3 

Set  another  timeout 
and  maintain  entry 
in  pair  table 

Data  Item  Name; 

Timeout  Time 

Data  Item  ID:  TMOUTM 

Data  Item  Description; 

This  Item  represents  the  system  clock  time  when  the 
timeout  on  a  given  message  pair  is  to  expire. 


Data  Item  Picture;  X(23)  Size  in  Bytes ;  23 

Coding  Type;  Alpha /Numeric  IDEFl  XRef ;  N/A 

Data  Item  Stability;  Dynamic  Legal  Value  Set  By; 

Source  MPU 

Where  Used;  Message  Pairing  Table 
Data 


Data 


Data 


Item  Name ;  Time  Stamp  When  Data  Item  ID;  TSMPA 

Accepted 

Item  Description; 

This  item  IS  used  in  the  Guaranteed  Delivery  Table  to 
identify  the  time  that  a  GD  message  was  accepted  by  it's 
source  MPU.  The  value  of  this  item  provides  the  base  for 
determining  the  "age"  of  the  message.  The  value  is 
represented  as  system  clock  time,  COBOL  PIC  X(23). 

Item  Name;  User  Name  Data  Item  ID:  USRNAM 
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Data  Item  Description: 

The  name  associated  with  a  given  human  user  of  the  IISS 
who  is  currently  logged  on  to  the  system. 

Data  Item  Picture:  X(8)  Size  in  Bytes :  8 

Coding  Type:  Alpha/Numeric  IDEFl  XRef :  EC  12 


Data  Item  Stability:  Static 


Legal  Value  Set  By: 
IISS  System 
Administrator 


Where  Used:  Logon  Table 
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APPENDIX  E 


E . 1  Message  Types 

This  section  defines  the  various  types  of  messages  that 
the  NTM  will  be  handling  in  the  IISS  Test  Bed.  Each  type  is 
defined  as  to  its  nature  and  implied  processing.  In  addition, 
the  header  values  and  data  portion  content  for  each  type  is 
provided. 

Certain  message  types  have  been  "canned"  to  facilitate 
their  creation  and  delivery,  particularly  when  an  error 
condition  occurs.  These  messages  are  indicated  by  an  asterisk 
(*)  . 


Table  E-1  is  an  overview  of  all  of  the  message  types  in 
terms  of  their  name,  code  ID,  category,  path,  and  next  immediate 
message  (where  applicable) . 

Table  E-2  provides  a  review  of  the  message  categories 
along  with  relevant  processing  performed  by  the  MPU  when  it 
receives  a  message  conforming  to  the  given  type. 

The  message  type  description  are  provided  in  alphabetical 
order  for  ease  of  access. 
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MESSAGE  TYPE  OVERVIEW 


Type 

Category 

Path 

'•Next  Msg" 

1 .  Abort  AP 

AB 

C 

••Parent"  MPU-Child  MPU 
Parent  AP  -  Child  MPU 

AP  Dying 

2.  Active  List 

AA 

F 

MPU 

-  Monitor 

(Opt . ) Operator 
Abort 

3 .  AP  Already 
Dead 

AM 

G 

MPU 

-  Monitor 

N/A 

4 .  AP  Alive 

AL 

G 

AP  - 

Local  MPU 

System  State 

5.  AP  Dying 

AD 

G 

AP  - 

Local  MPU 

(Opt.)  Abort 

AP 

6.  AP  Ending 

AE 

E 

MPU 

-  AP 

N/A 

7.  AP  Init  at  SD 

NL 

G 

MPU 

-  Monitor  AP 

N/A 

8.  AP  Interface 
Error* 

32 

E 

MPU 

-  Monitor  AP 

N/A 

9.  AP  Status 
Reguest 

SR 

B 

Any 

AP  -  Any  MPU 

AP  Status  Return 

10.  AP  Status 
Return 

IS 

F 

MPU 

-  Requesting  AP 

N/A 

11.  APC  Alive* 

LV 

E 

MPU 

-  Monitor  AP 

Global  Table 
Update 

12.  APC  Availa¬ 
bility 

Request 

AV 

D 

AP  - 

■  Local  MPU 

APC  Available 
Return 

13.  APC  Available  VR 

F 

Local  MPU  -  AP 

N/A 

Return 
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MESSAGE  TYPE  OVERVIEW  (Continued) 


Type. 

Cateqorv 

Path 

"Next  Msq" 

14  . 

APC  Name 
Request 

AN 

D 

AP  -  MPU 

APC  Name  Return 

15. 

APC  Name 
Return 

NA 

F 

MPU  -  AP 

16. 

APC  Status 
Request 

PS 

D 

AP  -  Local  MPU 

APC  Status 

Return 

17  . 

APC  Status 
Return 

PR 

F 

Local  MPU  -  AP 

N/A 

18. 

APC  Termi¬ 
nated 

CT 

E 

MPU  -  Monitor  AP 

N/A 

19. 

Cancel  Shut¬ 
down  CS 

C 

Monitor  AP  -  UI  AP 

N/A 

20. 

Change  Role 

21. 

Child  AP 
Status 

CD 

E 

Child  APS  MPU  - 
Parent  APs  MPU 
Cleanup 

(On  Child  Tree 
Completion) 

22.  Get  User 
Request 

UX 

E 

AP-Monitor 

Response 

Get  User 

23  . 

Get  User 
Response 

XU 

E 

Monitor  -  AP 

N/A 

24  . 

Cleanup 

CL 

C 

Child 

Parent  APs  MPU  - 
APs  MPU 

N/A 

25. 

GD  ACK 

GA 

C  Dest.  MPU  - 

Source  MPU 

N/A 

26. 

GD  Status 
Request 

GS 

D 

AP  -  Local  MPU 

GD  Status  Return 

27  . 

GD  Status 
Return 

GR 

F 

Local  MPU  -  AP 

N/A 

28  . 

Host  HU 
Active 

C 

Monitor  AP  - 

Local  MPU's 

N/A 

29  . 

Host  A- 
vailable 

HA 

E 

Monitor  AP  - 
Monitor  AP 

N/A 

30. 

Host  Name 
Request 

HN 

C 

AP  -  Local  MPU 

Host  Name  Return 
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TABLE  E-1 

MESSAGE  TYPE  OVERVIEW  (Continued) 


Type 

Category  Path 

"Next  Msg" 

31. 

Host  Name 
Return 

NH 

E  Local  MPU  -  AP 

N/A 

32  . 

Host  HR 

Status 

Request 

D 

AP  -  Local  MPU 

Host 

Return 

33  . 

Host  HO 
Status 

F 

Local  MPU  -  AP 

N/A 

34.  Host  HT 
Terminating 

F 

Monitor  AP  - 

Monitor  AP 

Update  Host 
Table 

35. 

Initiate 

Comm 

AP 

Cl  Monitor  AP  -  Comm  AP 

36. 

Link  Ac¬ 
tive 

LA 

I  Comm  AP  to 

Monitor  AP 

Host  Alive 

37  . 

Link  Fail 

LF 

I  Comm  AP  - 

Monitor  AP 

(Opt.)  Shutdown 
APCs 

38  . 

List  LR 
Request 

D 

Monitor  AP  -  MPU 

Active  List 

39. 

Logoff 

OF 

E  UI  to  Monitor  AP 

N/A 

40. 

Logon  LO 
Request 

E 

UI  AP  -  Monitor  AP 

Logon  Response 

41. 

Logon  LX 
Response 

E 

Monitor  AP-UI  AP 

N/A 

42  . 

Message 

After 

Timeout 

MT 

E  MPU  -  Monitor  AP 

N/A 

43  . 

Message 

Mgr. 

ACK* 

MA 

E  Local  MPU  - 

Msg.  Source  AP 

N/A 

N/A 
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TABLE  E-1 


MESSAGE  TYPE  OVERVIEW  (Continued) 


Type  Category 

44.  Message  34 

No  Accept* 

45.  Message  MQ 

for  Un¬ 
available 

APC* 


Path 


"Next  Msg" 


E  Local  MPU  -  Source  N/A 

AP 

E  MPU  -  Monitor  Queued  Start  APC 

(Operator  Option) 


46.  Message  RA 

Receive 

ACK 


AP  -  AP 


47.  Off-Host 

Shutting 
MPU  N/A 

Down 


HS  C 


Monitor  AP  - 


48.  Operator  OA 
Abort 


Monitor  AP  -  MPU  AP  Dying  -Or-Proc, 

Name  Not  Found 


49.  Paired  MS 

Message 

Status 

Request 

50.  Paired  MR 

Message 

Status 

Return 


D  AP  -  Local  MPU  Paired  Message 

Status  Return 


Local  MPU  -  AP  N/A 


51.  Process  NP 

Name  Not 

Found 

52.  Proces-*  31 

sing  Error* 

53.  Rebuild  RT 

Tables 


MPU  -  Monitor  AP 


MPU  -  Monitor  AP  N/A 


D  Monitor  -  MPU  Table  Data 

Request  Tables 

Rebuilt 
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MESSAGE 

TYPE 

OVERVIEW  (Continued) 

Type 

Category 

Path 

II 

Next  Msg" 

54  . 

Recover¬ 

able 

RE 

Error 

E 

AP  -  Monitor 

AP 

N/A 

55. 

Resource  33 

Unavailable* 

E 

MPU  -  Monitor 

N/A 

56. 

57  . 

Shutdown  DA 

AP 

Shutdown  AP  DC 
Cluster 

C 

D 

Monitor  AP  - 
MPU  -  MPU 
Monitor  AP  - 

MPU 

MPU  Soft 

AP  Dying 

Shutdown 

(opt. ) 

58. 

Shutdown 

Comm 

TR 

AP 

E 

Monitor  AP  - 

Comm  AP 

AP  Dying 

59. 

Shutdown 

Host 

SH 

B 

Monitor  AP  - 

Monitor  AP  Shutdown 

A  PC 

60. 

Shutdown 

Link 

SD 

B 

Monitor  AP  - 

Comm  AP 

N/A 

61. 

Shutdown  SP 

Pending 

C 

Monitor  AP  - 

UI  AP 

N/A 

62  . 

Signal 

Error 

SE 

E 

MPU  -  AP 

N/A 

63  . 

Soft  SD  C 

Shutdown 

Local 

MPU  -  AP 

AP  Dying 

64  . 

Start  Link 

L 

B 

Monitor  AP  - 

Comm  AP 
Link 

Link 

Fail 

Active  or 

65. 

Start  MPU 

SC 

C 

Monitor  AP  - 
Monitor's  MPU 

N/A 

66. 

System  State 

SS 

E 

Local 

MPU 

-  AP  N/A 

67  . 

Table  Data  DR 
Request 

B 

MPU  -  CDMRP 

Table 

Data 

Return 
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TABLE  E-1 

MESSAGE  TYPE  OVERVIEW  (Continued) 


Type  Category  Path  "Next  Msg" 


68  . 

Table  Data  DL 
Return 

F 

CDMRP  -  MPU 

N/A 

69. 

AP 

Table  Status 

Table  Statu 
Request* 

TS 

E 

MPU  -  Monitor 

Return 

70. 

MPU 

Table  Status 

N/A 

Return 

ST 

F 

Monitor  AP 

71. 

Tables  RB 

Rebuilt 

F 

MPU  -  Monitor 

N/A 

72  . 

Timeout  TE 

Expired* 

2 

MPU  -  Local  AP 

N/A 

73  . 

Unsolicited  CE 

APC  Termi¬ 
nation 

F 

MPU  -  Monitor 

Update  APC 

Table 

74  . 

Unsolicited  lA 

Initiation 

Accept 

G 

MPU  -  MPU 

N/A 

75. 

MPU 

Unsuccessful 

N/A 

Initiation 

NI 

G 

Child  MPU  - 

Parent 

76. 

Unstable  UT 

Table 

E 

MPU  -  Monitor 

N/A 

77  . 

Update  APC  UA 
Table 

E 

Monitor  AP  -  Monitor  AP  N/A 

78  . 

Update  Host  UA 

E 

Monitor  AP  -  Mon 

itor  AP 

N/A 

Table 
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TABLE  E-2 

MESSAGE  CATEGORY  REVIEW 


MPU  Special  Processing* 

(Beyond  basic  set  of 

Message  Management 

Category  ID  Category  Definition  Functions) 

A  Guaranteed  Delivery  At  Source 

1.  Checks  Authority 

2.  Creates  Entry  in 
Guaranteed 
Delivery  Table 

3 .  Logs  the  Message 

4 .  Sends  Accept  Status  to  AP 

5.  Routes  and  Sends  the 
Message 

At  Destination 

1.  Determines  whether  message 
requires  AP  initiation  (and 
does  so  if  required) 

2.  Delivers  Message 

3 .  Formats  and  Sends 
Guaranteed  Delivery  Accept 
message  on  receipt  of  CALL 
"GDACK"  from  AP 

At  Source  Again 

1.  On  receipt  of  Guaranteed 
Delivery  Accept  Message  - 
deletes  entry  in  Guaranteed 
Delivery  Table 

B  Response  Required  At  Source 

1.  Checks  Authority 

2.  Creates  Entry  in  Pair  Table 

3.  Logs  Message 

4.  Routes  and  Sends  Message 

At  Destination 

1.  Determines  whether  message 
requires  AP  initiation  (and 
does  so  if  required) 

2.  Delivers  Message 


*MPU  Special  Processing  is  treated  here  in  a  rather  general 
sense.  Details  of  these  functions  are  provided  in  Section  4.2. 
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TABLE  E-2 

MESSAGE  CATEGORY  REVIEW  (Continued) 


MPU  Special  Processing 
(Beyond  basic  set  of  Message 
Category  ID  Category 
Definition  Management 

Category  ID  Category  Definition  Functions) 


C 


D 


E 


System  Command  - 
No  Response 


System  Command  - 
Response  Required 


At  Source 

A.  Where  MPU  is  the  source 

1.  Formats  Message 

2 .  Logs  Message 

3 .  Routes  and  Sends 
Message 

B.  Where  Monitor  AP  is 

the  Source 

1.  Logs  Message 

2 .  Routes  and  Sends 
Message 

At  Destination 

1.  Performs  processing  in 
accordance  with 
Message  Type 

At  Source 

1.  Formats  Message 

2.  Creates  Entry  in  Pair 
Table 

3.  Logs  Message 

4.  Routes  and  Sends 
Message 


At  Destination 
1.  Performs  Processing  in 
accordance  with 
Message  Type 

Unsolicited  Message  At  Source 

A.  Where  MPU  is  the 
source 

1.  Formats  Message 

2 .  Logs  Message 

3 .  Routes  and  Sends 
Message 

B.  Where  local  AP  is  the 
Source 

1.  Logs  Message 

2.  Routes  and  Sends 
Message 

At  Destination 
1.  Determines  whether 
Message  requires  AP 
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Initiation  (and  does 
so,  if  required) 

2.  Delivers  Message 

3.  Sends  Initiation  ACK 
(if  required) 
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TABLE  E-2 

MESSAGE  CATEGORY  REVIEW  (Continued) 


Category  ID  Category  Definition 


MPU  Special  Processing 
(Beyond  basic  set  of  Message 
Management  functions) 


F 


G 


H 


Solicited  Message  At 

A. 


B. 


At 

1. 


2. 


AP  Status  Message  At 

(from  Local  AP 
to  its  MPU 
only) 

At 

1. 

2  . 


Initiation  Message  At 

1. 
2 . 
3 . 
4  . 


Source 

Where  MPU  is  the  source 

1.  Formats  Message 

2.  Logs  Message 

3 .  Routes  and  Sends 
Message 

Where  local  mP  is  the 
Source 

1 .  Logs  Message 

2 .  Routes  and  Sends 
Message 

Destination 

Locates  and  deletes  Entry 
in  Pair  Table  (if  entry 
is  still  in  pair  table  - 
if  entry  is  not  found  the 
message  is  discarded  and 
an  MT  message  is 
generated) 

Delivers  Message  (if 
entry  was  in  Pair  Table) 

Source 

N/A 


Destination 

Updates  AP  Status  Table 
Performs  any  processing 
implied  by  AP's  status 
(e.g.,  sending  status 
messages  to  the  AP's 
Parent,  requesting 
clean-up,  etc . ) 

Source 

Checks  Authority 
Creates  Child  Table  Entry 
Logs  Message 

Routes  and  Sends  Message 
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At  Destination 

1.  Initiates  AP 

2.  Creates  entries  in  AP 
Status  Table  and  I'm 
Alive  Table 
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TABLE  E-2 

MESSAGE  CATEGORY  REVIEW  (Continued) 


Cateqory  ID  Cateqory  Definition 


MPU  Special  Processing 
(Beyond  basic  set  of  Message 
Management  functions) 


Messages  from  COMM 


At  Source 

1.  Logs  Message 

2.  Creates  Entry  in  Pair 
Table 

3 .  Routes  and  Sends  Message 


At  Destination 

1.  Determines  whether 
message  requires  AP 
initiation  (and  does  so 
if  required) 

2.  Delivers  Message 


J 


Paired  Specific  At  Source 

Initiation  1.  Logs  Message 

2.  Creates  entries  in  Pair 
Table  and  child  table 

3 .  Routes  and  Sends  Message 


At  Destination 

1.  Initiates  New  AP  Instance 

2.  Delivers  Message 
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Type  ID:  AB 


Nature  of  Message: 

Message  to  an  MPU  informing  it  that  one  of  its  resident 
AP's  is  to  be  abnormally  terminated.  The  MPU  will  handle 
the  actual  abort  via  either  an  OS  call  or  by  sending  this 
message  to  the  APs  that  manage  "Soft  Aborts."  The  MPU's 
handling  of  this  message  is  determined  by  the  given  AP's 
characteristics  in  regard  to  aborts. 


Path:  Parent  MPU  -  Child  MPU 
Parent  AP  -  Child  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A 
092 
0013 
N  (Default) 

1  Channel  ID 

AB  (of  AP  to 

Child  MPU  be  aborted) 

Det  by  SysGen  Parameter 
Child  APC 


AP  Name  (AP  PIC 
to  be  aborted) 


PIC 


Parent  AP-or-Parent  MPU 
Parent  AP  Inst  -  or  -  MPU 
Instance 
Local  APC 

Filled  in  by  Source  MPU 
Given  by  Source  AP  Int. 

C 


from  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  Active  List  Type  ID:  AA 

Nature  of  Message: 

List  of  all  active  APs  on  a  given  AP  Cluster.  Response  to 
List  Request  Message. 


Path:  MPU  -  Monitor 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native 
Priority  Flag 
Message  Type 
AP  Name  (Dest, 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


For  all  Active  APs  on  APC 


092 

AP  Name 

PIC 

X(10) 

Variable 

Instance 

PIC 

X(2) 

Flag 

N  (Default) 

On  Abort 

Value 

PIC  X 

0 

(from  AP 

Chare . 

AA 

Table) 

) 

Monitor  AP 

Original 

Source 

PIC  X(15) 

Det  by  SysGen  Parameter 
Monitor's  APC 
Providing  the  List 
Det  by  SysGen  Parameter 
MPU's  APC 

Filled  in  by  Source  MPU 
0 
F 
0 

0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
MPU ' s  Channel 
0 
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Message  Type:  AP  Alive  Type  ID:  AL 

Nature  of  Message: 

Message  from  an  initiated  instance  of  an  AP  to  its  local 
MPU  informing  it  that  the  AP  is  up  and  ready  to  run.  Upon 
receipt,  the  MPU  will  delete  the  relevant  entry  in  its 
•'I'm  alive  table."  Further,  the  MPU  will  update  the  AP 
Status  Table  entry  for  the  given  AP  Instance. 


Path:  AP  -  Local  MPU 

Header  Fields  _  Header  Values _ Data  Fields  Data  Values 


N 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 


A 
092 
0012 
(Default) 

0 

AL 

Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 
Init.  AP 

Assigned  by  MPU  at  Init 
Local  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Int 
G 


AP  Process  Name  PIC  X(12) 


(Default) 

1 

1 

(Default) 


Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


0  (Default) 
blank  (Default) 
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Message  Type:  AP  Already  Dead*  Type  ID:  AM 

Nature  of  Message: 

Sent  when  an  MPU  attempts  to  deliver  a  message  to  an  AP 
that  has  terminated. 


Path:  MPU  -  Monitor  AP 


Header  Fields  Header  Values 


Data  Fields  Data  Values 


N 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank 
Original  Source 
Channel  ID 
Continuation  Flag 


A 
092 
0017 
(Default) 

0 
AM 

Monitor  AP 

Det  by  SysGen  Parameter 

Monitors  APC 

Dead  APs  MPU 

Det  by  SysGen  Parameter 

Local  APC 

Filled  in  by  Source  MPU 


Status  Code 
Name  String 
(Process  name 
of  Dead  AP) 
Filler 


PIC  X(5) 
PIC  X(7) 


PIC  X(5) 


1 

G 

(Default) 

1 

1 

(Default) 


From  AP  Char.  Table 


(Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


0  (Default) 
blank  (Default) 
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Message  Type:  AP  Dying  Type  ID:  AD 

Nature  of  Message: 

AP  Status  information  given  to  the  AP's  MPU  when  the  AP  is 
terminating.  The  MPU  will  use  the  data  provided  to  update 
the  local  AP  Status  Table.  The  MPU  will  then  send  a  child 
status  message  to  the  dying  AP's  Parent  MPU. 

Path:  AP  -  MPU 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
Complete 
AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 


A 
092 
0001 
N  (Default) 
0 
AD 


Termination 

Status 


PIC  X 

88  Normal 
Term. 

88  Shutdown 


Term.  AP's  MPU  88  Ab 

Det  by  SysGen  Parameter  88  Ex 

Local  APC  Co 

Term.  AP 

Assigned  by  MPU  at  Init 
Local  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
G 

'  From  AP  Char.  Table 


88  Aborted 
88  Exception 
Condition 


Integrity  Check  Flag  0  (Default) 

Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 

Delivery  Time  Trigger 

Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


0  (Default) 
blank  (Default) 
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Message  Type:  AP  Ending  Type  ID:  AE 

Nature  of  Message: 

Message  sent  when  the  AP's  having  the  characteristic  of 
requiring  a  message  on  a  child  AP's  termination. 


Path:  MPU  -  AP 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 

A 

Child  Process 

Header  Length 

092 

Name 

PIC 

X(12) 

Data  Length 

0016 

Child  Channel 

Binary/Native  Flag 

N  (Default) 

ID 

PIC 

X(3) 

Priority  Flag 

0 

Child 

PIC 

X 

Message  Type 

AE 

Termination 

AP  Name  (Dest.) 

Parent  AP 

Status 

Instance  (Dest.) 

Assigned  by  MPU 

at  Init 

Local  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 
Filled  in  by 
1 


APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 

Message  Category  G 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


Source  MPU 


From  AP  Char.  Table 


1 
1 

(Default) 


0  (Default) 
blank  (Default) 
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Message  Type:  AP  Interface  Error  (to  Monitor)*  Type  ID:  32 
Nature  of  Message: 

Message  sent  to  the  Monitor  AP  when  the  MPU  discovers 
errors  in  the  message  header  as  formatted  by  the  AP 
Interface.  The  MPU  also  sends  an  AI  message  to  the  Source 
AP  (using  a  different  format  -  See  AP  Interface  Error  -  to 
Source  AP) . 


Path:  MPU  -  Monitor  AP 


Header  Fields _ Header  Values _ Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  AI  Error  Code  PIC  X(5) 

092 

0017  AP  Name  PIC  X(7) 

N  (Default  -  Native) 

0  Processing  code  PIC  X(5) 

32 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
MPU  at  Error  Source 
Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 
E 

0  (Default) 

0  (Default  -  No) 

1  (Yes) 

1  (Yes) 

0  (Default  -  No) 

0  (Default  -  Immed.) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
APC  Name 
0 
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Message  Type:  AP  Interface  Error  (to  Source  AP) *  Type  ID:  32 
Nature  of  Message: 

Sent  to  the  Source  AP  when  the  MPU  discover  an  error  in 
the  message  header  header  as  formatted  by  the  AP 
Interface. 


Path:  MPU  -  Source  AP 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


Error  Code 


Bad  Header 


N 


A 
092 
0102 
(Default) 

0 

32 

Error  Source  AP 
Error  Source  AP  Instance 
Local  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Local  MPU 
1 


PIC  X(5) 


PIC  X(92) 


Processing  code 


PIC  X(5) 


Message  Category  E 

Priority  of  Source  AP 

Integrity  Check  Flag  0  (Default) 

Logging  Flag  1 

Stat.  Collection  Flag 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 

Delivery  Time  Trigger 

Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  Monitor  AP 

Channel  ID  APC  Name 

Continuation  Flag  0 


From  AP  Char.  Table 


0  (Default  ) 
blank  (Default) 
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Message  Type:  AP  Initiating  at  Shutdown*  Type  ID:  NL 

Nature  of  Message: 

Message  informing  the  operator  that  an  AP  is  in  the 
process  of  initiating.  This  message  is  sent  (if  the  AP 
state  exists)  during  shutdown  procedures  undertaken  upon 
receipt  of  a  shutdown  AP  or  shutdown  APC  command. 


Path:  MPU  -  Monitor  AP 


Header  Fields 


Header  Values 


Data  Fields 


Data  Values 


N 


Status  Code 
Name  String 
(AP  in  Init) 
Filler 


A 
092 
0017 

(Default) 

0 

NL 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source 
Channel  ID 
Continuation  Flag 


PIC  X(5) 
PIC  X(7) 

PIC  X(5) 


AP's  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 


(Default) 

1 

1 

(Default) 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 


of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  AP  Status  Request  Type  ID:  SR 
Nature  of  Message: 

Request  for  the  current  status  of  a  given  AP.  The  request 
will  cause  a  table  lookup  of  the  given  AP's  APC  AP  Status 
Table. 


Path:  Any  AP  -  Any  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 

Binary/Native  Flag  N 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  AP  Name  (for 

092  which  status 

0010  required) 

Default) 

0 

SR 

Given  AP's  MPU 

Det  by  SysGen  Parameter 

MPU's  APC 

Calling  AP 

Calling  AP  Inst. 

Local  APC 

Filled  in  by  Source  MPU 
Given  by  Source  AP  Int. 

B 

From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
Specified  or  Default 
0 


is 


PIC  X(10) 
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Message  Type:  AP  Status  Return  Type  ID:  IS 

Nature  of  Message: 

Return  on  an  AP  Status  Request. 

Path:  MPU  -  Requesting  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


N 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  SR  Msg 

Channel  ID  of  SR  Msg 

Continuation  Flag  0 


A  AP  Name  PIC  X(10) 

092  (specified  in 

0011  Status  Request) 

(Default) 

0  AP  Status  PIC  X 

IS 

Source  of  SR  Message 
Source  Inst  of  SR  Message 
Source  APC  of  SR  Message 
Given  AP's  MPU 
Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
0 
F 
0 

(Default) 

1 
1 

(Default) 

0  (Default) 
blank  (Default) 
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Message  Type:  APC  Alive*  Type  ID:  LV 

Nature  of  Message: 

Status  message  informing  Monitor  AP  that  the  APC  has 
completed  its  start-up  processing  and  is  ready  to  accept 
messages.  Upon  receipt,  the  Monitor  AP  will  update  it's 
own  APC  status  table  and  send  an  "APC  Table  Update" 
message  to  its  off-host  siblings. 


Path:  MPU  -  Monitor  AP 


Header  Fields 


Header  Values 


Data  Fields  Data  Fields 


N 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 

Message  Category  E 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


A 
092 

0017  Filler 

(Default) 

0 

LV 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
APC's  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 


Status  Code  PIC  X(5) 


PIC  X(12) 


0  (Default) 


0  (Default) 
blank  (Default) 
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Message  Type:  APC  Availability  Request  Type  ID:  AV 

Nature  of  Message: 

Sent  as  a  result  of  an  AP  invoking  the  "WKONCA"  service. 
The  data  portion  contains  the  name  of  the  APC  of  interest 
to  the  calling  APC. 


Path:  AP  -  Local  MPU 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


A  APC  Name 

092 
0003 
N  (Default) 

1 

AV 

Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 
Reguesting  AP 
Assigned  by  MPU  at  Init 
Local  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
D 


PIC  X(3) 


Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 


Original  Source 
Channel  ID 
Continuation  Flag 


of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  APC  Available  Return  Type  ID:  VR 

Nature  of  Message: 

Sent  as  the  response  to  the  APC  Availability  Request 
Message . 


Path:  Local  MPU  -  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  APC  Status 

092 
0003 

N  (Default) 

0 

VR 

Source  of  AV  Message 
Source  Inst  of  AV  Message 
Local  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 
F 

From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


PIC  X(3) 

88  APC  up 
88  APC  Not 
Found 
88  Time 
Out 

(if  APC 
does  not 
come  up 
within 
reasonable 
period  of 
time) 
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Message  Type:  APC  Name  Request  Type  ID:  AN 

Nature  of  Message: 

Sent  as  a  result  of  an  AP  invoking  the  "WHATAC"  service. 
The  MPU  will  read  the  AP  Information  Table  to  find  the  APC 
upon  which  the  given  AP  resides. 


Path:  AP  -  Local  MPU 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


A  AP  Name 

092 
0010 
N  (Default) 

1 

AN 

Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 
Requesting  AP 
Assigned  by  MPU  at  Init 
Local  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
D 


PIC  X(10) 


Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 


Original  Source 
Channel  ID 
Continuation  Flag 


of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  APC  Name  Return  Type  ID:  NA 

Nature  of  Message: 

Sent  in  response  to  the  APC  Name  Request  message.  The 
data  portion  contains  the  name  of  the  APC  on  which  the 
given  AP  resides.  In  the  event  that  the  given  AP  name  was 
not  found,  the  data  portion  will  contain  a  three  character 
error  code. 


Path:  Local  MPU  -  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


N 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  #  Filled  in 

Processing  Code  1 

Message  Category  F 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 


A  APC  Name 

092 
0003 

( Default) 

0 

NA 

Source  of  AN  Message 
Source  Inst  of  AN  Message 
Local  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 


PIC  X(3) 


by  Source  MPU 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 


Original  Source 
Channel  ID 
Continuation  Flag 


of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  APC  Status  Request  Type  ID:  PS 

Nature  of  Message: 

Sent  as  a  result  of  an  AP  invoking  the  "ACSTAT"  service. 
The  data  portion  contains  the  name  of  the  APC  of  interest 
to  the  calling  AP. 


Path:  AP  -  Local  MPU 


Header  Fields  Header  Values  Data  Fields  Data  Values 


N 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 


A  APC  Name 

092 
0003 
(Default) 

0 

PS 

Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 
Requesting  AP 
Assigned  by  MPU  at  In it 
Local  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
D 


PIC  X(3) 


From  AP  Char.  Table 


(Default) 

1 

1 

(Default) 


Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 


0  (Default) 
blank  (Default) 


Original  Source 
Channel  ID 
Continuation  Flag 


of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


I 
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Message  Type:  APC  Status  Return  Type  ID;  PR 

Nature  of  Message: 

Sent  in  response  to  the  APC  status  request  message.  The 
data  portion  contains  the  current  status  of  the  given  APC. 


Path:  AP  -  Local  MPU 

Header  Fields  Header  Values  Data  Fields  Data  V 


N 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  #  Filled  in  by 

Processing  Code  1 

Message  Category  F 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank 


A  APC  Status 

092 
0001 
(Default) 

0 

PR 

Source  of  PS  Message 
Source  Inst  of  PS  Message 
Local  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 


PIC  X 


Source  MPU 


Original  Source  of  Msg, 
Channel  ID  of  Msg. 
Continuation  Flag 


(Default) 
Source 
Source 
0 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 


AP 

AP 
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Message  Type:  APC  Terminated*  Type  ID:  CT 

Nature  of  Message: 

Notification  that  an  APC  has  completed  the  shutdown 
processing  requested  by  the  Monitor  AP. 


Path:  MPU  -  Monitor  AP 


Header  Fields _ Header  Values _ Data  Fields  Data  Values 

Header  Format  A  Status  Code  PIC  X(5) 

Header  Length  092 

Data  Length  0017  Filler  PIC  X(12) 

Binary/Native  Flag  N  (Default) 

Priority  Flag  0 

Message  Type  CT 

AP  Name  (Dest.)  Monitor  AP 

Instance  (Dest.)  Det  by  SysGen  Parameter 

APC  Name  (Dest.)  Monitor's  APC 

AP  Name  (Source)  Shutdown  APC's  MPU 

Instance  (Source)  Det  by  SysGen  Parameter 

APC  Name  (Source)  Local  APC 

Message  Serial  #  Filled  in  by  Source  MPU 

Processing  Code  1 

Message  Category  E 

Priority  of  Source  AP  0 

Integrity  Check  Flag  0  (Default) 

Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag  0  (Default) 

Delivery  Time  Trigger  blank  (Default) 

Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 
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Message  Type:  Cancel  Shutdown  Type  ID:  CS 

Nature  of  Message: 

Message  overriding  a  shutdown  in  X  minutes  notice.  This 
message  is  applicable  only  if  the  shutdown  pending  is 
still  outstanding.  Once  shutdown  procedures  have  begun, 
they  cannot  be  stopped. 


Path:  Monitor  AP  -  UI  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format  A 
Header  Length  092 

Data  Length  0 
Binary/Native  Flag  N  (Default) 
Priority  Flag  1 
Message  Type  CS 


N/A 


AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank 
Original  Source 
Channel  ID 
Continuation  Flag 


UI  AP 

Assigned  by  MPU  at  Init 
UI  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 


From  AP  Char.  Table 


( Default) 
1 
1 

(Default) 


(Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


0  (Default) 
blank  (Default) 
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Message  Type:  Change  Role 


Type  ID:  CR 


Nature  of  Message: 

Allows  a  user  to  change  roles  within  a  given  session.  The 
new  role  must  be  one  that  the  user  is  authorized  for. 


Path:  UI  AP  -  Monitor  AP 


Header  Fields _ 1 

Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.)  1 

Instance  (Dest.) 

APC  Name  (Dest.)  ] 

AP  Name  (Source)  i 

Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code  ' 

Message  Category 
Priority  of  Source  AP 


Header  Values 


Data  Fields 


Data  Values 


A  Terminal  ID  PIC  X(2) 

092 

0020  User  Name  PIC  X 

N  (Default) 

0  New  Role  PIC  X 

CR 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor’s  APC 
UI  AP 

Assigned  by  MPU  at  Init 
UI's  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
E 

’  From  AP  Char.  Table 


User  Name 


New  Role 


PIC  X(8) 
PIC  X(10) 


Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (r'-tc.ult) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  olank  ;Default^ 
Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


0  (Default) 
blank  (Default) 
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Message  Type:  Child  AP  Status  Type  ID:  CA 

Nature  of  Message: 

Relevant  status  of  a  child  AP.  The  data  is  sent  to  the 
Parent  AP's  MPU  upon  specified  events.  Upon  receipt  of  the 
message,  given  the  child's  status,  the  Parent  AP's  MPU  may 
send  a  cleanup  message  back  to  the  child's  MPU. 


Path:  Child  AP's  MPU  -  Parent  AP's  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
(Default) 

Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A 

Process  Name 

PIC  X(12) 

092 

0016 

(of  child) 

N  (Default) 

Channel  ID 

PIC  X(3) 

0 

(of  child) 

CA 

Parent  MPU 

Child  AP 

PIC  X 

Det  by  SysGen 
Parameter 

Status 

88  Abort 

From  Dest  AP  Name 

Acknowl 

Child  MPU 

88  Child 

Det  by  SysGen  Parameter 

Normally 
Termin ' d 

Local  APC 

Filled  in  by  Source  MPU 

No  Active 

0 

Children 

E 

88  Child 

0 

Shutdown 

0  (Default) 

in  APC  SD 

1 

88  Child 

1 

Shutdown 

0  (Default) 

in  AP  SD 

0  (Default) 
blank 

Shutdown 

88  Ch 

blank  (Default) 

in  Host  SD 

of  Msg.  Source 

AP 

88  Child 

of  Msg.  Source 

AP 

Initiated 

0 

88  Normal 
Termi¬ 
nation 
Active 
Children 
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Message  Type:  Cleanup  Type  ID:  CL 

Nature  of  Message: 

Notification  to  clean  up  tables  and  messages  for  a  given 
AP.  Sent  when  all  child  AP's  below  a  point  have  terminated 
with  no  active  children  of  their  own.  The  child  AP's  MPU 
can  now  delete  the  child's  entry  in  the  AP  Status  table. 


Path:  Parent  AP's  MPU  -  Child  AP's  MPU 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format  A  ] 

Header  Length  092 

Data  Length  0015 

Binary/Native  Flag  N  (Default)  ( 

Priority  Flag  1 

Message  Type  CL 

AP  Name  (Dest.)  Child  AP  MPU 

Instance  (Dest.)  Det  by  SysGen  Pari 

APC  Name  (Dest.)  Child  APC 

AP  Name  (Source)  Parent  AP  MPU 

Instance  (Source)  Det  by  SysGen  Par. 

APC  Name  (Source)  Local  APC 

Message  Serial  #  Filled  in  by  Sour* 

Processing  Code  0 

Message  Category  C 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


Process  Name  PIC  X(12) 
(of  child) 


Channel  ID 
(of  child) 


PIC  X(3) 


Child  AP  MPU 

Det  by  SysGen  Parameter 

Child  APC 

Parent  AP  MPU 

Det  by  SysGen  Parameter 

Local  APC 

Filled  in  by  Source  MPU 
0 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 
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Message  Type:  GD  ACK  Type  ID:  GA 

Nature  of  Message: 

Acknowledgment  of  the  fact  that  a  message  requiring 
Guaranteed  Delivery  was  received  and  processed  by  its 
destination  AP.  Upon  receipt  of  this  message,  the  source 
MPU  will  clean  up  its  GD  table  and  logs  for  the  specified 
message . 


Path:  Destination  MPU  -  Source  MPU 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


A  GD  Sou 

092  GD  Mes 

0010  Serial 

N  (Default) 

1 

GA 

GD  Source  MPU 

Det  by  SysGen  Parameter 

MPU's  APC 

Destination  MPU 

Det  by  SysGen  Parameter 

Local  APC 

Filled  in  by  Source  MPU 
0 


GD  Source  APC  PIC  X(3) 
GD  Message  PIC  X(7) 
Serial  # 


Message  Category  C 

Priority  of  Source  AP  0 

Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


0  (Default) 
blank  (Default) 
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Message  Type:  Get  User  Response  Type  ID:  UX 

Nature  of  Message: 

Sent  in  response  to  a  Get  User  Request.  The  monitor  AP 
will  use  the  original  source  AP  to  access  the  Logon  Table 
for  the  data  values  to  be  sent  back  to  the  requesting  AP. 
The  status  field  indicates  success  or  failure  of  the  table 
search. 


Path:  Monitor  Requesting  AP 


Header  Fields 


Header  Values 


Data  Fields 


Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


A  Status 

092  User  Name 

0021  Role  Name 

N  (Default)  Terminal  ID 

0 
UX 

Source  of  Request 
Det  by  SysGen  Parameter 
Request  Source  APC 
VAX  Monitor 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 


PIC  X 
PIC  X(8) 
PIC  X(10) 
PIC  X(2) 


Messa<^e  Category  E 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  XGU 

Continuation  Flag  0 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 
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Message  Type:  Get  User  Request  Type  ID:  XU 
Nature  of  Message: 

Request  from  AP  (via  GETUSR  service)  for  the  User  Name, 
Role  Name,  and  Terminal  ID  of  the  AP's  original  source 
where  the  original  source  is  a  User  Interface  AP. 


Path:  AP  Monitor 


Header  Fields _ Header  Values  Data  Fields  Data  Values 


N 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 

Message  Category  E 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  XGU 

Continuation  Flag  0 


A 
092 
0015 
( Default) 

0 

XU 

VAX  Monitor 

Det  by  SysGen  Parameter 
Monitor's  APC 
Requesting  AP 
Det  by  SysGen  Parameter 
Requesting  AP's  APC 
Filled  in  by  Source  MPU 
1 


Original 
Source  of 
Requesting  AP 


PIC  X(15) 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 
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Message  Type:  GD  Status  Request  Type  ID:  GS 

Nature  of  Message: 

Sent  as  a  result  of  an  AP  invoking  the  "GDSTAT"  service. 
The  data  portion  contains  the  source  and  serial  number  of 
the  Guaranteed  Delivery  Message  of  interest  to  the  calling 
AP. 


Path:  AP  -  Local  MPU 


Header  Fields 


Header  Values 


Data  Fields 


Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  ( Dest . ) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code  ' 

Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 


A  GD  Message 

092  Source  AP  Name  PIC  X(10) 

0017  GD  Message 

N  (Default)  Serial  Number  PIC  X(7) 

1 
GS 

Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 
Requesting  AP 
Assigned  by  MPU  at  Init 
Local  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
D 

'  From  AP  Char.  Table. 

0 (Default) 

1 

f  1 

0  (Default) 

f  0  (Default) 

blank  (Default) 


Test  Flag  0  (Default) 

Delivery  Trigger  Flag 

Delivery  Time  Trigger 

Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


E-40 


DS  620342000 
30  September  1990 


Message  Type:  GD  Status  Return  Type  ID:  GR 

Nature  of  Message: 

Sent  in  response  to  a  GD  Status  Request.  The  data  portion 
contains  the  current  status  of  the  Guaranteed  Delivery 
messages  specified  in  the  request. 


Path:  Local  MPU  -  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 

Data  Length 
Binary/Native 


Flag 


N 


A 

092 

0003 

(Default) 


Return  Code 


0 

GR 

Source  of  GS  Message 
Source  Inst  of  GS  Message 
Local  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Source  MPU 


Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  #  Filled  in  by 

Processing  Code  1 

Message  Category  F 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


PIC  X(3) 

88 

GD-Message 

-in-system 

88 

GD-Message 

-Not-Found 


From  AP  Char.  Table. 


0  (Default) 
blank  (Default) 
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Message  Type:  Host  Active  Type  ID:  HU 

Nature  of  Message: 

Message  sent  to  all  on-host  APCs  to  inform  them  that  the 
host  has  completed  its  startup  processing. 


Path:  Monitor  AP  -  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


A  N/A 

092 
0000 

N  (Default  -  Native) 

1 

HU 

MPU  Name 

Det  by  SysGen  Parameter 
MPU's  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 
C 


Message  Category  C 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1  (Yes) 

Stat.  Collection  Flag  1  (Yes) 

Test  Flag  0  (Default  -  No) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


(Default) 


0  (Default  -  Immed) 
blank  (Default) 
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Message  Type:  Host  Available  Type  ID:  HA 

Nature  of  Message: 

Message  sent  at  startup  to  inform  off-host  Monitor  APs 
that  a  given  host  has  completed  its  startup  processing  and 
is  now  available  to  receive  messages. 


Path:  Monitor  AP  -  Monitor  AP 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 

Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 

AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


Variable 
N  (Default 
0 
HA 


For  each  on-host  APC 


APC  Name  PIC  X(3) 

Native)  APC  Status  PIC  X 


Off-host  Monitor  AP 
Det  by  SysGen  Parameter 
Monitor's  APC 
On-Host  Monitor  AP 
Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 
E 


Message  Category  E 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default  -  No) 

Logging  Flag  1  (Yes) 

Stat.  Collection  Flag  1  (Yes) 

Test  Flag  0  (Default  -  No) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


(Default) 


0  (Default  -  Immed) 
blank  (Default) 
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Message  Type:  Host  Name  Request 


Type  ID:  HN 


Nature  of  Message: 

Sent  as  a  result  of  an  AP  invoking  the  "WHTHST"  Service, 
The  data  portion  contains  the  name  of  the  AP  whose  host 
name  is  being  requested. 


Path:  AP  -  Local  MPU 


Header  Fields 


Header  Format 
Header  Length 

Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 

AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source' 
Message  Serial 
Processing  Coc  ^  ^ 

Message  Category 
Priority  of  Source  AP 


Header  Values  Data  Fields  Data  Values 


AP  Name 


PIC  X(10) 


0010 

N  (Default) 

1 

HN 

Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 
Requesting  AP 
Assigned  by  MPU  at  Init 
Local  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
C 

From  AP  Char.  Table 


Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


0  (Default) 
blank  (Default) 
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Message  Type:  Host  Name  Return  Type  ID:  NH 

Nature  of  Message: 

Sent  in  response  to  a  Host  Name  Request  Message.  The  data 
portion  contains  the  name  of  the  Host  associated  with  the 
given  AP. 


Path:  Local  MPU  -  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format  A 

Header  Length  092 

Data  Length  0013 

Binary/Native  Flag  N  (Default) 
Priority  Flag  0 

Message  Type  NH 


Host  Name  PIC  X(3) 

AP  Name  PIC  X(10) 


AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


Source  of  HN  Message 
Source  Inst  of  HN  Message 
Local  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 


0  (Default) 
1 
1 

(Default) 


From  AP  Char.  Table 


blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


0  (Default) 
blank  (Default) 
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Message  Type:  Host  Status  Request  Type  ID:  HR 

Nature  of  Message: 

Sent  as  a  result  of  an  AP  invoking  the  ’’HSTATS”  service. 
The  data  portion  contains  the  name  of  the  host  whose 
status  is  of  interest  to  the  calling  AP. 


Path:  AP  -  I.ocal  MPU 


Header  Fields 


Header  Values 


Data  Fields 


Data  Values 


Header  Format 
Header  Length 

Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 


A 

092 

0003 

N  (Default) 
1 
HR 


Host  Name 


PIC  X(3) 


AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank 


Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 
Requesting  AP 
Assigned  by  MPU  at  Init 
Local  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
D 


0  (Default) 
1 
1 

(Default) 


(Default) 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 


Original  Source  of  Msg.  Source  AP 
Channel  ID  of  Msg.  Source  AP 
Continuation  Flag  0 
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Message  Type:  Host  Status  Return  Type  ID:  HO 

Nature  of  Message: 

Sent  in  response  to  a  Host  Status  Request  message.  The 
data  portion  contains  the  current  status  of  the  Host  named 
in  the  Host  Status  Request. 


Path:  Local  MPU  -  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


N 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 


A  Host  Status 

092  Host  Name 

0004 

(Default) 

0 

HO 

Source  of  HR  Message 
Source  Inst  of  HR  Message 
Local  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 


PIC  X 
PIC  X(3) 


( Default) 
1 
1 

(Default) 


Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 


Original  Source 
Channel  ID 
Continuation  Flag 


of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  Host  Terminating  Type  ID:  HT 

Nature  of  Message: 

Message  sent  when  a  Non-VAX  host  shuts  down. 

Path:  Monitor  AP  -  Monitor  AP 


Header  Fields  Header  Values _ Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


A  N/A 

092 
0 

N  (Default) 

0 

HT 

VAX  Monitor  AP 
Det  by  SysGen  Parameter 
VAX  Monitor  APC 
Non-VAX  Monitor  AP 
Det  by  SysGen  Parameter 
Non-VAX  Monitor  APC 
Filled  in  by  Source  MPU 
1 
F 

From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default) 

0  (Default) 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
Monitor  AP  Channel 
0 
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Message  Type:  Initiate  COMM  AP  Type  ID;  Cl 

Nature  of  Message: 

Message  requesting  the  initiation  of  a  given  COMM  AP. 


Path:  Monitor  AP  -  COMM  AP 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


N 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  COMM  AP  Channel 

Continuation  Flag  0 


A  N/A 

092 
0 

(Default  -  Native) 

1 

Cl 

COMM  AP 

Det  by  SysGen  Parameter 
COMM  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 


H 

(Default  -  No) 
1  (Yes) 
1  (Yes) 
(Default  -  No) 


0  (Default) 


0  (Default  -  Immed) 
blank  (Default) 
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Message  Type;  Link  Active  Type  ID:  LA 

Nature  of  Message: 

Message  from  a  COMM  AP  reporting  the  successful 
establishment  of  a  link  to  its  off-host  sibling.  Upon 
receipt,  Monitor  AP  will  update  the  link  status  table  and 
send  a  "Host  Available"  message  to  the  off-host  monitor  at 
the  other  end  of  the  link. 


Path:  COMM  AP  to  Monitor  AP 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


A 
092 
0 

N  (Default) 

0 

LA 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
COMM  AP 

Det  by  SysGen  Parameter 
COMM's  APC 

Filled  in  by  Source  MPU 
1 


N/A 

Specific  Link  is 
implied  by 
COMM  AP  Name 


Message  Category  I 

Priority  of  Source  AP  0 

Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 


0  (Default) 
blank  (Default) 


Original  Source 
Channel  ID 
Continuation  Flag 


Of  Msg  Source  AP 
COMM  AP  Channel 
0 


I 
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Message  Type;  Link  Fail  Type  ID:  LF 

Nature  of  Message: 

Message  from  COMM  AP  informing  Monitor  that  a  formerly 
active  link  has  gone  down.  This  message  type  is  also  used 
as  a  return  on  a  "Start  Link"  message. 


Path:  COMM  AP  -  Monitor  AP 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


N 


A 
092 
0 

( Default) 

0 
LF 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
COMM  AP 

Det  by  SysGen  Parameter 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 

Message  Category  I 

Priority  of  Source  AP  0 

Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source 
Channel  ID 
Continuation  Flag 


N/A  -  The  Link 
in  question  is 
implied  by  the 
name  of  the 
Source  COMM  AP 


COMM's  APC 
Filled  in  by  Source  MPU 
1 


0  (Default) 
blank  (Default) 


Of  Msg  Source  AP 
COMM  AP  Channel 
0 
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Type  ID:  LR 


Nature  of  Message: 

Request  from  IISS  Operator  (via  Monitor)  for  a  list  of  all 
active  APs  on  a  specified  AP  Cluster. 


Path:  Monitor  AP  -  MPU 


Header  Fields 


Header  Format 
Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


Header  Values  Data  Fields  Data  Values 


A  N/A 

092 
0 

N  (Default) 

1 

LR 

Specified  APC  MPU 
Det  by  SysGen  Parameter 
Specified  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 


Header 


Message  Category  D 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  Msg.  Source  AP 

Channel  ID  APC's  Channel 

Continuation  Flag  0 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 
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Message  Type:  Logoff  Type  ID:  OF 

Nature  of  Message: 

Notification  from  UI  that  a  given  user  has  logged  off  the 
IISS  System.  Upon  receipt  of  this  message,  Monitor  AP  will 
delete  the  relevant  entry  in  the  Logon  Table. 


Path:  UI  to  Monitor  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.)  ] 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 


A  UI  (AP)  N 

092  UI  APC  Na 

0015  Terminal 

N  (Default) 

0 

OF 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
UI  AP 

Assigned  by  MPU  at  AP  Init 
UI ' s  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Int 
E 

’  0 


UI  (AP)  Name  PIC  X(10) 
UI  APC  Name  PIC  X(3) 
Terminal  ID  PIC  X(2) 


Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


0  (Default) 
blank  (Default) 
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Message  Type:  Logon  Request  Typo  ID:  LO 

Nature  of  Message: 

Message  from  a  UI  AP  informing  Monitor  AP  of  a  successful 
Logon.  Upon  receipt  of  this  message,  Monitor  will 
transfer  the  data  portion  to  the  Logon  Table. 


Path:  UI  AP  -  Monitor  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format  A  i 

Header  Length  092  i 

Data  Length  0062  ' 

Binary/Native  Flag  N  (Default)  i 

Priority  Flag  0 

Message  Type  LO 

AP  Name  (Dest.)  Monitor  AP 

Instance  (Dest.)  Det  by  SysGen  i 

Parameter 

APC  Name  (Dest.)  Monitor’s  APC 

AP  Name  (Source)  UI  AP  i 

Instance  (Source)  Assigned  by  MPU  a 

APC  Name  (Source)  UI's  APC 

Message  Serial  #  Filled  in  by  Sout 

Processing  Code  Given  by  AP  Int 

Message  Category  E 

Priority  of  Source  AP  0 

Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


UI  (AP)  Name  PIC  X(10) 
UI  APC  Name  PIC  Xp) 
Terminal  ID  PIC  X(2) 
User  Name  PIC  X(8) 

Role  Name  PIC  X(10) 

Session  Start  PIC  X(23) 
Time 

Channel  Range  PIC  X(3) 
Start 

Channel  Range  PIC  X(3) 


Assigned  by  MPU  at  AP  Init  End 
UI's  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Int 
E 

'  0 


0  (Default) 
blank  (Default) 
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Message  Type:  Message  After  Timeout  Type  ID:  MT 

Nature  of  Mes£>cige: 

Message  to  Monitor  that  a  reply  message  on  a  given  message 
pair  arrived  after  timeout  had  expired. 


Path:  MPU  -  Monitor  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 


A 
092 
0092 
N  (Default) 

0 

MT 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Pair  Request  Source  MPU 
Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
0 


Header  of  Tardy 
Message 


PIC  X(92) 


Processing  Code 

Message  Category  E 

Priority  of  Source  AP  0 

Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source 
Channel  ID 
Continuation  Flag 


(Default) 


0  (Default) 
blank  (Default) 


of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  Logon  Response  Type  ID:  LX 

Nature  of  Message: 

Sent  to  inform  the  UI  of  the  status  of  the  LOGON  Table 
upon  completion  of  processing  the  Logon  Message. 


Path:  Monitor  AP  -  UI 


Header  Fields 


Header  Values _ Data  Fields  Data  Values 


N 


Log 

Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 


A 
092 
0001 
(Default) 

1 

LX 

Source  of  Logon  Message 

Det  by  SysGen  Parameter 

Logon  Source  APC 

VAX  Monitor  AP 

Det  by  SysGen  Parameter 

Monitor  AP's  APC 

Filled  in  by  Source  MPU 


Table  Status  PIC  X 
88  Entry-Made  Value 
88  Table-Full  Value 


1 

E 

(Default) 

1 

1 

(Default) 


From  AP  Char.  Table 


Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  UIV 

Continuation  Flag  0 


0  (Default) 
blank  (Default) 


II 2^  II 

II 0" 
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Message  Type:  Message  Manager  ACK*  Type  ID:  MA 

Nature  of  Message: 

Acknowledgment  from  the  MPU  that  the  message  from  the 
source  AP  was  found  to  be  acceptable.  The  entire  header 
from  the  accepted  message  is  returned  to  be  used  later  by 
the  source  AP. 


Path:  Local  MPU  -  Msg.  Source  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format  A 
Header  Length  092 
Data  Length  0092 
Binary/Native  Flag  N  (Default) 
Priority  Flag  0 
Message  Type  MA 


Entire  header  PIC  X(92) 

of  Accepted 

Message 


Source  AP 

Assigned  by  MPU  at  AP  Init 
Source  AP's  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 


AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


Filled  in  by 
1 
E 
0 

(Default) 

1 
1 

(Default) 


Source  MPU 


0  (Default) 
blank  (Default) 
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Message  Type:  Message  No  Accept*  Type  ID:  ME 

Nature  of  Message: 

Notification  that  a  given  message  cannot  be  accepted. 
Message  is  logged  and  thrown  away.  The  message  source  is 
informed  of  the  problem  via  the  error  code  parameter.  In 
certain  cases,  the  Monitor  AP  will  also  be  informed  of  the 
problem. 


Path:  Local  MPU  -  Source  AP 


Header  Fields 


Header  Values 


Data  Fields 


Data  Values 


N 


Filled 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank 
Original  Source 
Channel  ID 
Continuation  Flag 


A 
092 
0097 
(Default) 

0 

ME 

Source  AP  of 


Message  Error  PIC  X(5) 
Code 


Entire  Original 
Header 


PIC  X  (92) 


NACK's  Msg 


Assigned  by  MPU  at  AP  Init 
Source  AP's  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 


in  by 
1 
E 


Source  MPU 


(Default) 

1 

1 

(Default) 


From  AP  Char.  Table 


(Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


0  (Default) 
blank  (Default) 
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Message  Type:  Message  Queued  for  Type  ID:  MQ 

Unavailable  APC* 

Nature  of  Message: 

Message  informing  the  Operator  that  a  message  is  being 
held  for  an  AP  residing  on  a  currently  unavailable  APC. 
The  operator  may  choose  to  start  the  APC. 


Path:  MPU  -  Monitor  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


N 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source 
Channel  ID 
Continuation  Flag 


Status  Code 
Name  String 
Processing 
Code 


A 
092 
0017 

(Default) 

0 

MQ 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Msg.  Source  MPU 
Det  by  SysGen  Parameter 
Msg.  Source  APC 
Filled  in  by  Source  MPU 
1 


PIC  X(5) 
PIC  X(7) 
PIC  X(5) 


(Default) 

1 

1 

(Default) 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 


of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  Message  Receive  ACK  Type  ID:  RA 

Nature  of  Message: 

Sent  to  acknowledge  the  receipt  of  a  message  by  the 
message's  destination  AP.  Note:  This  message  type  may  be 
used  to  acknowledge  those  requiring  Guaranteed  Delivery 
Services . 


Path:  AP  -  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


A  APC  Name  (from 

092  Rec'd  Msg) 

0010 

N  (Default)  Msg  Seria 

0  (from  Rec 

RA 

Ack'd  Msg  Source  AP 
Ack'd  Msg  Source  Instance 
Ack'd  Msg  Source  APC 
Receiving  AP 

Assigned  by  MPU  at  AP  Init 
Local  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
F 


PIC  X(3) 


Msg  Serial  #  PIC  X(7) 
(from  Rec'd  Msg) 


Message  Category  F 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  from  Rec'd  Msg 

Channel  ID  from  Rec'd  Msg 

Continuation  Flag  0 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 
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Message  Type:  Off-Host  Shutting  Down  Type  ID:  HS 

Nature  of  Message: 

Message  from  Monitor  to  its  on-host  APC's  to  i-.f^rm  them 
of  an  off-host  shutdown.  The  APC  MPU's  can  chen  take 
appropriate  action  as  required  (e.g.,  not  trying  to  rout'- 
and  send  a  message  to  the  shutdown  host) . 


Path:  Monitor  AP  -  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


N 


A 
092 
0003 
(Default 
1 
HS 

On-Host  APC  MPU 

Det  by  SysGen  Parameter 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source 
Channel  ID 
Continuation  Flag 


Host  Name  (of  PIC  X(3) 

host  shutting 

down) 

Native) 


Dest.  MPU's  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 


(Default  -  No) 
1  (Yes) 
1  (Yes) 
(Default  -  No) 


0  (Default) 


0  (Default  -  Immed) 
blank  (Default) 


of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  Operator  Abort  Type  ID:  OA 

Nature  of  Message: 

Command  from  the  Operator  telling  the  MPU  to  abort  a 
specific  instance  of  an  AP.  The  MPU  will  handle  the  abort 
in  the  manner  specified  for  "Abort  AP." 


Path:  Monitor  AP  -  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format  A  AP  Name  (of  AP 

Header  Length  092  to  be  aborted) 

Data  Length  0012 

Binary/Native  Flag  N  (Default)  Instance  (known 

Priority  Flag  1  to  Operator 

Message  Type  OA  from  Active  List) 

AP  Name  (Dest.)  "Aborting"  AP's  MPU 

Instance  (Dest.)  Det  by  SysGen  Parameter 

APC  Name  (Dest.)  MPU ' s  APC 

AP  Name  (Source)  Monitor  AP 

Instance  (Source)  Det  by  SysGen  Parameter 

APC  Name  (Source)  Local  APC 

Message  Serial  #  Filled  in  by  Source  MPU 

Processing  Code  1 

Message  Category  C 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 

Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 

Delivery  Time  Trigger  1 

Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


AP  Name  (of  AP 
to  be  aborted) 


From  AP  Char.  Table 


PIC  X(10) 


PIC  X(2) 


0  (Default) 
blank  (Default) 
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Message  Type:  Paired  Message  Status  Request  Type  ID:  MS 

Nature  of  Message: 

Sent  as  a  result  of  an  AP  invoking  the  "PRSTAT"  Service. 
The  data  portion  contains  the  parameters  given  in  the 
call . 


Path:  AP  -  Local  MPU 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


Paired  Message 
Destination 
AP  Name 
Paired  Message 
Logical 
Channel 


PIC  X(3) 


Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


A  Paired  Message  PIC  X(10) 

092 
0013 

N  (Default) 

1 
MS 

Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 
Requesting  AP 
Assigned  by  MPU  at  Init 
Local  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
D 

From  AP  Char.  Table 


0  (Default) 
blank  (Default) 
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Message  Type:  Paired  Message  Status  Return  Type  ID:  MR 

Nature  of  Message: 

Sent  in  response  to  a  Paired  Message  Status  Request.  The 
data  portion  contains  the  current  status  of  the  Paired 
Message  specified  in  the  request. 


Path:  Local  MPU  -  AP 


Header  Fields _ Header  Values _ Data  Fields  Data  Values 


N 


Header  Format 
Header  Length 
Data  Length 
in-system 

Binary/Native  Flag 
Priority  Flag 
Not-Found 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source 
Channel  ID 
Continuation  Flag 


A  Return  Code 

092 
0005 

(Default) 

0 

MR 

Source  of  MS  Message 
Source  Inst  of  MS  Message 
Local  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 


PIC  X(5) 

88  Message- 


88  Message- 


From  AP  Char.  Table 


(Default) 

1 

1 

(Default) 


0  (Default) 
blank  (Default) 


of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  Process  Name  Not  Found  Type  ID:  NP 

Nature  of  Message: 

Sent  by  an  MPU  when  it  cannot  find  an  AP  specified  to  be 
aborted  in  the  AP  Status  Table.  This  is  a  possible 
response  to  an  Operator  Abort  Message. 


Path:  MPU  -  Monitor  AP 

Header  Fields  Header  Values  Data  Fields  Data  Values 


A 
092 
0012 
( Default 
0 
NP 

Monitor  AP 


N 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source 
Channel  ID 
Continuation  Flag 


in 


AP  Name 
(specified 
OA  Msg) 
Native) 

Instance 
(specified  in 
OA  Msg) 


PIC  X(10) 


PIC  X(2) 


Det  by  SysGen  Parameter 
Monitor's  APC 
Aborting  AP's  MPU 
Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 


(Default  -  No) 
1  (Yes) 
1  (Yes) 
(Default  -  No) 


0  (Default) 


0  (Default  -  Immed) 
blank  (Default) 


of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  Processing  Error*  Type  ID:  31 

Nature  of  Message: 

Message  sent  from  an  MPU  when  it  encounters  problems 
during  its  normal  processing.  The  header  portion  is  hard 
coded  in  the  event  that  the  problem  encountered  is  within 
the  MPU  itself. 


Path:  MPU  -  Monitor  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


A  Error  Code 

092 

0017  Name  S 

N  (Default  -  Native) 

0  Proces 

31 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor’s  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 


PIC  X(5) 


Name  String  PIC  X(7) 
Native) 

Processing  Code  PIC  X(5) 


Message  Category  E 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default  -  No) 

Logging  Flag  1  (Yes) 

Stat.  Collection  Flag  1  (Yes) 

Test  Flag  0  (Default  -  No) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


0  (Default) 


0  (Default  -  Immed) 
blank  (Default) 
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Message  Type:  Rebuild  Tables  Type  ID:  RT 

Nature  of  Message: 

Used  on  Startup  by  Monitor  to  inform  an  MPU  that  it  must 
rebuild  its  tables  from  the  CDM.  This  message  applies  only 
to  those  MPU's  that  must  build  their  tables  before  the 
CDMRP  comes  up.  It  is  used  only  where  there  is  a  table 
configuration  change. 


Path:  Monitor  -  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 


A  N/A 

092 
0 

N  (Default  -  Native) 

1 

RT 

MPU 

Det  by  SysGen  Parameter 
MPU's  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 
D 


Priority  of  Source  AP  0  ( 

Integrity  Check  Flag  0  (Default  -  No) 

Logging  Flag  1  (Yes) 

Stat.  Collection  Flag  1  (Yes) 

Test  Flag  0  (Default  -  No) 

Delivery  Trigger  Flag  0  ( 

Delivery  Time  Trigger  bla 

Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  specified  or  default 

Continuation  Flag  0 


0  (Default) 


0  (Default  -  Immed) 
blank  (Default) 
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Message  Type:  Recoverable  Error  Type  ID:  RE 

Nature  of  Message: 

Notification  that  a  given  AP  has  encountered  a  recoverable 
error. 


Path:  AP  -  Monitor  AP 


Header  Fields _ 

Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


Header  Values 


A  AP  Error  ' 

092 
0005 
N  (Default) 

0 

RE 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
AP  where  error  occurred 
Assigned  by  MPU  at  AP  Init 
AP's  APC 

Filled  in  by  Source  MPU 
Given  by  AP  Interface 
E 


Data  Fields  Data  Values 
AP  Error  Code  PIC  X(5) 


Message  Category  E 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  Source  AP 

Channel  ID  of  Source  AP 

Continuation  Flag  0 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 
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Message  Type:  Resource  Unavailable*  Type  ID;  33 

Nature  of  Message: 

Informational  message  sent  to  Monitor  AP  when  an  MPU 
rejects  any  message  due  to  the  fact  of  a  needed  resource 
being  unavailable. 


Path:  MPU  -  Monitor 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


A  Error  Code 

092 

0017  Name  S 

N  (Default  -  Native) 

0  Proces 

33 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
MPU 

Det  by  SysGen  Parameter 
MPU's  APC 

Filled  in  by  Source  MPU 
1 


PIC  X(5) 


Name  String  PIC  X(7) 
Native) 

Processing  Code  PIC  X(5) 


Message  Category  E 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default  -  No) 

Logging  Flag  1  (Yes) 

Stat.  Collection  Flag  1  (Yes) 

Test  Flag  0  (Default  -  No) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


0  (Default) 


0  (Default  -  Immed) 
blank  (Default) 
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Message  Type:  Shutdown  AP  Type  ID:  DA 

Nature  of  Message: 

Command  to  an  MPU  telling  it  to  shut  down  one  of  its 
resident  APs.  The  MPU  will  handle  the  actual  shutdown  in 
accordance  with  the  given  AP's  characteristics.  Where  the 
given  AP  has  active  child  AP's,  the  MPU  will  also  send 
shutdown  AP  messages  to  the  child  AP  MPUs. 


Path:  Monitor  AP  -  MPU;  MPU  -  MPU 


Header  Fields _ Header  Values _ Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 


A  AP  Name  (to  be 

092  shut  down) 

0015  Instance 

N  (Default)  (where  known) 

1  Channel  ID 

DA 

Shutting  down  AP's  MPU 
Det  by  SysGen  Parameter 
AP's  APC 

Monitor  AP  or  Parent 
AP  MPU 


PIC  X(10) 
PIC  X(2) 
PIC  X(3) 


Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 


Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 

Message  Category  C 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 
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Message  Type:  Shutdown  AP  Cluster  Type  ID:  DC 

Nature  of  Message: 

System  Command  to  gracefully  shut  down  a  given  cluster. 
Implies  that  the  cluster's  MPU  will  handle  the  shutdown  of 
all  resident  AP's  and  will  also  shut  itself  down  after  all 
AP's  and  messages  are  cleared-  Where  resident  AP's  have 
child  AP's  and  the  shutdown  type;  host  or  APC,  the  MPU 
will  also  send  shutdown  AP  messages  to  the  child  AP  MPU's 
(where  the  child  AP's  are  off-APC) . 


Path:  Monitor  AP  -  MPU 


Header  Fields 


Header  Values Data  Fields  Data  Values 


N 


A 
092 
0001 
(Default) 

1 

DC 

MPU 

Det  by  SysGen  Parameter 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 


Shutdown  Type  PIC  X 

88  IISS 
88  Host 
88  APC 


MPU's  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 


D 

(Default) 

1 

1 

(Default) 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 


Original  Source 
Channel  ID 
Continuation  Flag 


of  Msg.  Source  AP 
specified  or  default 
0 
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Message  Type:  Shutdown  COMM  AP  Type  ID:  TR 

Nature  of  Message: 

Message  to  a  given  COMM  AP  telling  it  to  shut  itself  down. 
Path:  Monitor  AP  -  COMM  AP 


Header  Fields _ Header  Values _ Data  Fields  Data  Values 


Header  Format 
Header  Length 


A 

092 


N/A 


N 


(Default  -  Native) 

0 

TR 

COMM  AP 

Det  by  SysGen  Parameter 
COMM's  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor’s  APC 
Filled  in  by  Source  MPU 
1 


Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  COMM  AP's  Channel 

Continuation  Flag  0 


(Default 

1 

1 

(Default 


-  No) 
(Yes) 
(Yes) 

-  No) 


0  (Default) 


0  (Default  -  Immed) 
blank  (Default) 
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Message  Type:  Shutdown  Host  Type  ID:  SH 
Nature  of  Message: 

System  command  from  one  Monitor  AP  to  an  off-host  sibling 
telling  the  sibling  to  shutdown  all  IISS  functionality  on 
its  host.  The  off-host  Monitor  AP  will, upon  receipt,  send 
Shutdown  APC  messages  to  all  of  its  on-host  APC's. 


Path:  Monitor  AP  -  Monitor  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


N 


A 
092 
0 

(Default) 

0 
SH 

Off-host  Monitor  AP 
Det  by  SysGen  Parameter 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source 
Channel  ID 
Continuation  Flag 


N/A  -  Host  to 
be  shutdown  is 
implied  by 
Dest.  Monitor 
AP  Name 


Off-Host  Monitor's  APC 
On-host  Monitor  AP 
Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 
B 
0 

(Default) 

1 
1 

(Default) 


0  (Default) 
blank  (Default) 


of  Msg. 
of  Msg. 


Source  AP 
Source  AP 
0 
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Message  Type:  Shutdown  Link  Type  ID:  SD 

Nature  of  Message: 

Command  to  terminate  an  active  link  between  a  COMM  AP  and 
its  off-host  sibling. 


Path:  Monitor  AP  -  COMM  AP 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 

Message  Category  B 

Priority  of  Source  AP  0 

Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  COMM  AP's  Channel 

Continuation  Flag  0 


A  N/A 

092 
0 

N  (Default) 

0 

SD 

COMM  AP 

Det  by  SysGen  Parameter 
COMM's  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 


0  (Default) 
blank  (Default) 
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Message  Type:  Signal  Table  Error  Type  ID:  SE 

Nature  of  Message: 

Sent  to  the  message  source  AP  on  the  occurrence  of  an 
entry-not-found  in  the  NTM  Tables.  This  message  is  sent 
only  when  the  error  creates  a  situation  where  the  source 
AP's  message  cannot  be  processed.  The  message  contains  a 
brief  description  of  the  error  and  where  it  occurred. 


Path :  MPU  AP 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


N 


Filled 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source 

Channel  ID  000 

Continuation  Flag  0 


Error  Source 
NTM  Error 
Return 
Error 

Description 


PIC  X(5) 


PIC  X(72) 


A  Error  Source  PIC  X(10) 

092 
0087 

(Default) 

0 
SE 

Source  of  Message  Causing  Error 
Det  by  SysGen  Parameter 
Source  Msg  APC 
MPU  where  error  occurred 
Det  by  SysGen  Parameter 
Local  APC 

Source  MPU 


in  by 
1 
E 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 


AP 
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Message  Type:  Shutdown  Pending  Type  ID:  SP 

Nature  of  Message: 

Notification  that  an  IISS  shutdown  of  a  specified  type 
will  begin  in  X  minutes.  This  notification  may  be 
overridden  by  a  cancel  shutdown  (CS)  Message. 


Path:  Monitor  AP  -  UI  AP 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


A 
092 
0004 
N  (Default) 

1 
SP 

UI  MPU 

Det  by  SysGen  Parameter 
UI's  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 


Shutdown  Data  PIC  X(2) 
Time  Until  PIC  X(2) 
Shutdown 
(in  Minutes) 


Message  Category  C 

Priority  of  Source  AP  0 

Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 


0  (Default) 
blank  (Default) 


Original  Source 
Channel  ID 
Continuation  Flag 


of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  Soft  Shutdown  Type  ID:  SD 

Nature  of  Message: 

Message  telling  a  specified  AP  to  shut  itself  down.  This 
message  can  only  be  sent  to  an  AP  that  has  the  internal 
logic  required  to  perform  its  own  shutdown  (as  determined 
from  the  AP  Characteristics  Table) .  This  message  is  sent 
as  a  result  of  receiving  a  Shutdown  APC  message. 


Path:  MPU  -  AP 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Serial  # 


A  N/A 

092 
0 

N  (Default) 

0 

SD 

AP  to  be  shutdown 
Det  by  SysGen  Parameter 
Local  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 
Filled  in  by 
0 


Source  MPU 


Code 

Message  Category  C 

Priority  of  Source  AP  0 

Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source 
Channel  ID 
Continuation  Flag 


0  (Default) 
blank  (Default) 


of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  Start  Link  Type  ID:  SL 

Nature  of  Message: 

Message  to  a  specified  COMM  AP  telling  it  to  establish  the 
link  between  itself  and  its  off-host  sibling.  The  MPU  will 
create  an  entry  in  the  pair  table  to  set  a  wait  on  the 
link  status  return. 


Path:  Monitor  AP  -  COMM  AP 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


N 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category  B 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source 
Channel  ID 
Continuation  Flag 


A 
092 
0 

(Default) 

0 

SL 

COMM  AP 

Det  by  SysGen  Parameter 
COMM  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 


N/A  -  the  dest. 
COMM  AP  can 
only  start 
one  link 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 


of  Msg.  Source  AP 
COMM  AP's  Channel 
0 
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Message  Type:  Start  MPU  Type  ID:  SC 

Nature  of  Message: 

Command  to  startup  (spawn)  a  given  MPU. 

Path:  Monitor  AP  -  Monitor's  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


092 


Header  Format 
Header  Length 

Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 


Process  Name 


0012 
N  (Default) 

1 

SC 

Monitor's  MPU 
Det  by  SysGen  Parameter 
Monitor's  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 
C 
0 

0  (Default) 

1 
1 

0  (Default) 

0  (Default) 


PIC  X(12) 

(of  MPU  to 
be 

started) 


blank  (Default) 


Original  Source 
Channel  ID 
Continuation  Flag 


of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  System  State  Type  ID:  SS 

Nature  of  Message: 

Sent  to  an  AP  when  the  AP's  "alive"  status  is  known.  This 
message  serves  to  inform  the  AP  of  the  current  state  of 
the  IISS,  along  with  certain  characteristics  of  the  AP. 


Path:  MPU 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


A  System 

092  Logica 

0022  Origin 

N  (Default)  MPU  In 

0  Number 

SS  Mailbo 

"Alive"  AP 

Det  by  SysGen  Parameter 
Alive  AP's  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 


System  State 
Logical  Channel 
Original  Source 
MPU  Instance 
Number  of 
Mailboxes 


PIC  X 
PIC  X(3) 
PIC  X(15) 
PIC  X(2) 
PIC  X 


Message  Category  E 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  000 

Continuation  Flag  0 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 
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Message  Type:  Table  Data  Request  Type  ID:  DR 

Nature  of  Message: 

Message  to  the  CDM  requesting  a  download  of  the  static 
table  data  values.  This  is  done  when  the  MPU  is  told  of  a 
CDM  configuration  change.  This  message  is  hard  coded  as 
part  of  the  MPU's  startup  file. 


Path:  MPU  -  CDMRP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


N 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 

Message  Category  B 

Priority  of  Source  AP  0 

Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source 
Channel  ID 
Continuation  Flag 


A  N/A 

092 
0 

(Default) 

0 

DR 

CDMRP 

Det  by  SysGen  Parameter 
CDM's  APC 
Requesting  MPU 
Det  by  SysGen  Parameter 
Requesting  MPU's  APC 
Filled  in  by  Source  MPU 
0 


0  (Default) 
blank  (Default) 


of  Msg.  Source  AP 
specified 

0 
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Message  Type:  Table  Data  Return  Type  ID:  DL 

Nature  of  Message: 

Indicates  that  the  data  following  the  header  is  to  be  used 
to  update  the  MPU's  local  tables. 


Path:  CDMRP  -  MPU 


Header  Fields _ Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Loc  ging  Flag 
Stat.  Collection  Flag 
Te' t  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank 


A 
092 
up  to  1908 
N  (Default) 

0 

DL(Dest. ) 

Requesting  MPU 

Det  by  SysGen  Parameter 

Requesting  MPU’s  APC 

CDMRP 

Det  by  SysGen  Parameter 
CDM's  APC 


Updated  Static  Up  to 
Table  Data  PIC  X(1908) 


Filled  in  by 
From  AP  Int 
F 
0 

(Default) 

1 
1 

(Default) 


Source  MPU 


Original  Source 
Channel  ID 
Continuation  Flag 


(Default) 
from  DR  Msg 
from  DR  Msg 
as  req'd 


0  (Default) 
blank  (Default) 


I 

1 

i 
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Message  Type:  Table  Status  Request*  Type  ID:  TS 

Nature  of  Message: 

Request  from  an  MPU  at  its  startup  for  the  configuration 
status  of  its  tables.  This  message  is  hard  coded  as  part  of 
the  MPU's  startup  file. 


Path:  MPU  -  Monitor  AP 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 


Status  Code 
Filler 


A 
092 
0017 
N  (Default) 

0 

TS 

Monitor  AP 

Det  by  SysGen  Parameter 

Monitor's  APC 

MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 


PIC  X(5) 
PIC  X(12) 


Processing  Code 
Message  Category  E 

Priority  of  Source  AP  0 

Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag 
Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source 
Channel  ID 
Continuation  Flag 


0  (Default) 
blank  (Default) 


of  Msg.  Source  AP 


MPU's 


Channel 
0 
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Message  Type:  Table  Status  Return  Type  ID:  ST 

Nature  of  Message: 

Current  configuration  status  of  the  MPU's  tables.  Upon 
receipt  of  this  message,  the  MPU  will  know  whether  it  can 
build  its  tables  completely  from  its  existing  files  or  if 
it  has  to  reguest  its  static  table  data  from  the  CDM. 


Path:  Monitor  AP  -  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


N 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 


A 
092 
0001 
(Default) 

0 

TR 

Requesting  MPU 
Det  by  SysGen  Parameter 
Requesting  MPU • s  APC 
Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
Filled  in  by  Source  MPU 
1 
F 
0 

(Default) 

1 
1 

(Default) 


Table  Status  PIC 


X 

88  Local 
Tables 

O  K 
88  Get 
Data 
from 
CDM 


Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 


0  (Default) 
blank  (Default) 


Original  Source 
Channel  ID 
Continuation  Flag 


of  Msg  Source  AP 
MPU ' s  Channel 
0 
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Message  Type:  Tables  Rebuilt  Type  ID:  RB 

Nature  of  Message: 

Sent  to  Monitor  upon  successful  (or  unsuccessful) 
completion  of  the  task  of  rebuilding  local  tables  using 
updated  CDM  data. 


Path:  MPU  -  Monitor 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


N 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  Msg  Source  AP 

Channel  ID  MPU ' s  Channel 

Continuation  Flag  0 


A 
092 
0001 

(Default  -  Native) 

0 

RB 

Monitor  AP 

Det  by  SysGen  Parameter 

Monitor's  APC 

MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
0 


Table  Status 


PIC  X 

88  Rebuilt 
88  Unsuc¬ 
cessful 


(Default  -  No) 
1  (Yes) 
1  (Yes) 
(Default  -  No) 


0  (Default) 


0  (Default  -  Immed) 
blank  (Default) 
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Message  Type:  Timeout  Expired* 


Type  ID:  TE 


Nature  of  Message: 

Message  informing  an  AP  that  the  timeout  on  a  paired 
message  has  expired  before  the  response  message  arrived 
This  message  can  only  be  sent  to  AP's  having  the  logic 
required  to  accept  unsolicited  messages  (based  on  AP's 
On-Timeout  characteristic) . 


Path:  MPU  -  Local  AP 


Header  Fields _ 

Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


Header  Values 


Data  Fields  Data  Values 


A  Error  Cod 

092  Message  H 

0097 

N  (Default  -  Native) 

0 

TE 

AP  Requesting  Pair 
Assigned  by  MPU  at  AP  Init 
AP's  APC 
Local  MPU 

Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 


Error  Code  Pic  X(5) 
Message  Header  PIC  X(92) 


Message  Category  E 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default  -  No) 
Logging  Flag  1  (Yes) 

Stat.  Collection  Flag 

Test  Flag  0  (Default  -  No) 

Delivery  Trigger  Flag 

Delivery  Time  Trigger 

Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  Msg.  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


(Default) 


1  (Yes) 

0  (Default  -  Immed) 
blank  (Default) 
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Message  Type:  Unsolicited  APC  Termination*  Type  ID:  CE 

Nature  of  Message: 

Message  sent  when  an  APC  shuts  down  for  internal  reasons 
(other  than  on  operator  command) . 


Path:  MPU  -  Monitor  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 

Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 

Instance  (Source) 

APC  Name  (Source) 

Message  Serial  # 

Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag  0 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank 
Original  Source 
Channel  ID 
Continuation  Flag 


Error  Code 
Filler 


A 

092 
0017 

N  (Default) 

0 

CE 

Monitor  AP 

Det  by  SysGen  Parameter 
Monitor's  APC 
MPU  of  Terminating  APC 
Det  by  SysGen  Parameter 
Terminating  APC 
Filled  in  by  Source  MPU 
1 


PIC  X(5) 
PIC  X(12) 


From  AP  Char.  Table 


(Default) 

1 

1 

(Default) 


(Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 


0  (Default) 
blank  (Default) 
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Message  Type:  Unsolicited  Initiation  Accept  Type  ID:  lA 

Nature  of  Message: 

Acknowledgment  that  an  AP  was  initiated  upon  receipt  of  an 
unsolicited  message.  Upon  receipt  of  this  ACK,  the  MPU 
will  modify  the  entry  in  the  Child  Status  Table  to 
indicate  a  confirmed  child  AP. 


Path:  MPU  -  MPU 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 


A 

092 

0025 

N  (Default)  Process  ] 

0  Init  Msg 

lA  Source  AP 

Init  Msg  Source  MPU 
Det  by  SysGen  Parameter 


Name  (of  PIC 
X(12) 


Source  APC 
Init  AP's  MPU 
Det  by  SysGen 
Parameter 
Init  AP's  APC 
Filled  in  by 
Source  MPU 
1 

G 


AP  Name  (of  AP 
Init  by  Unsol. 
Msg) 


PIC  X(10) 


Processing  Code  1  ' 

Message  Category  G 

Priority  of  Source  AP 

Table 

Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 

Original  Source  of  Msg,  Source  AP 

Channel  ID  of  Msg.  Source  AP 

Continuation  Flag  0 


Channel  ID  PIC  X(3) 
(Child  Init. 

From  AP  Char.  Under  from 
Init  Msg) 


0  (Default) 
blank  (Default) 
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Message  Type:  Unstable  Table  Type  ID:  UT 

Nature  of  Message: 

Sent  on  the  occurrence  of  an  entry-not-found  in  the  NTM 
Tables  where  the  error  occurs  due  to  a  problem  within  the 
NTM  as  opposed  to  bad  input.  The  message  carries 
information  that  pinpoints  the  error  for  the  operator.  In 
most  cases,  this  message  should  result  in  the  Operator 
shutting  down  the  NTM. 


Path:  MPU  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Cede 


A  Table  Name 

092  Module  Name 

0044  Error  Field 

N  (Default)  Error  Value 

0  Error  Return 

UT 

VAX  Monitor 

Det  by  SysGen  Parameter 
Monitor's  APC 
MPU  where  error  occurred 
Det  by  SysGen  Parameter 
Local  APC 

Filled  in  by  Source  MPU 
1 


Message  Category  E 

Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default) 
Logging  Flag  1 

Stat.  Collection  Flag  1 

Test  Flag  0  (Default) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source  of  Msg.  Source  AP 

Channel  ID  000 

Continuation  Flag  0 


PIC  X(3) 
PIC  X(6) 
PIC  X(10) 
PIC  X(20) 
PIC  X(5) 


From  AP  Char.  Table 


0  (Default) 
blank  (Default) 
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Message  Type:  Unsuccessful  Initiation  Type  ID:  NI 

Nature  of  Message: 

Sent  to  the  MPU  of  the  source  AP  of  a  specific  initiation 
message  when  the  requested  initiation  is  not  successful. 
Upon  receipt,  the  source  (or  Parent)  MPU  will  delete  the 
relevant  child  table  entry. 


Path:  Child  MPU  -  Parent  MPU 


Header  Fields 


Header  Values 


Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 
APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 
APC  Name  (Source) 
Message  Serial  # 
Processing  Code 


A 
092 
0022 
N  (Default 
0 
NI 

Source  MPU  of  Init  Msg 
Det  by  SysGen  Parameter 
Source  MPU's  APC 
Dest  MPU  of  Init  Msg 
Det  by  SysGen  Parameter 
Dest  MPU's  APC 
Filled  in  by  Source  MPU 
1 
E 


AP  Name  (from  PIC  X(10) 

Init  Msg) 

Parent  AP  PIC  X(12) 

Native) Process  Name 


Messa<je  Category 
Priority  of  Source  AP 
Integrity  Check  Flag  0  (Default  -  No) 
Logging  Flag  1  (Yes) 

Stat.  Collection  Flag  1  (Yes) 

Test  Flag  0  (Default  -  No) 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond.  blank  (Default) 
Original  Source 
Channel  ID 
Continuation  Flag 


0  (Default) 


0  (Default  -  Immed) 
blank  (Default) 


from  Init  Msg 
from  Init  Msg 
0 
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Message  Type:  Update  APC  Table  Type  ID:  UA 

Nature  of  Message: 

Message  informing  an  off-host  Monitor  AP  of  APC  Status 
table  updates. 


Path:  Monitor  AP  -  Monitor  AP 


Header  Fields  Header  Values  Data  Fields  Data  Values 


Header  Format  A  Status  Update  PIC  X 

Header  Length  092 


Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 
Continuation  Flag 


0001 

N  (Default) 

0 

UA 

Off-Host  Monitor  AP 
Det  by  SysGen  Parameter 
Off-Host  Monitor's  APC 
VAX  Monitor  AP 
Det  by  SysGen  Parameter 
VAX  Monitor's  APC 
Filled  in  by  Source  MPU 
1 
E 

From  AP  Char.  Table 
0 
1 
1 

0  (Default 
0  (Default 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
0 
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Message  Type:  Update  Host  Table  Type  ID:  UH 

Nature  of  Message: 

Message  informing  an  off-host  Monitor  AP  of  Host  table 
updates . 


Path:  Monitor  AP  -  Monitor  AP 


Header  Fields 


Header  Values  Data  Fields  Data  Values 


Header  Format 
Header  Length 
Data  Length 
Binary/Native  Flag 
Priority  Flag 
Message  Type 
AP  Name  (Dest.) 
Instance  (Dest.) 

APC  Name  (Dest.) 

AP  Name  (Source) 
Instance  (Source) 

APC  Name  (Source) 
Message  Serial  # 
Processing  Code 
Message  Category 
Priority  of  Source  AP 
Integrity  Check  Flag 
Logging  Flag 
Stat.  Collection  Flag 
Test  Flag 

Delivery  Trigger  Flag 
Delivery  Time  Trigger 
Delivery  Trig.  Cond. 
Original  Source 
Channel  ID 


A  Host  Name  PIC  X(3) 

092  Status  Update  PIC  X 

0004 

N  (Default) 

0 

UA 

Off-Host  Monitor  AP 
Det  by  SysGen  Parameter 
Off-Host  Monitor's  APC 
Local  Monitor  AP 
Det  by  SysGen  Parameter 
Local  Monitor  APC 
Filled  in  by  Source  MPU 
1 
E 

From  AP  Char.  Table 
0  (Default) 

1 

1 

0  (Default 
0  (Default 
blank  (Default) 
blank  (Default) 
of  Msg.  Source  AP 
of  Msg.  Source  AP 
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E.2.1  Error  Messaqe  Handlinc 


When  an  error  occurs  within  (or  is  detected  by)  the  MPli, 
an  error  message  is  sent  to  either  the  Monitor  AP,  the  source  AP 
(where  the  error  is  related  to  a  message) ,  or  both.  However, 
sending  an  error  message  in  the  normal  fashion  (by  writing  to 
the  MPU's  own  mailbox  and  performing  all  the  message  management 
functions)  could  easily  result  in  an  infinite  loop.  To  avoid 
this,  the  MPU  will  have  an  error  message  formatting  routine  that 
formats  and  effects  the  send  of  the  error  messages  to  either 
Monitor  AP,  the  Source  AP,  or  both.  In  the  event  that  the 
Monitor  AP's  mailbox  is  inaccessible,  the  fatal  error  processing 
routine  (ERRPRO)  will  be  called.  The  MPU's  error  formatting 
routine  will  have  access  to  two  "canned"  headers  and  will  be 
accessed  by  two  MPU  routines  described  below. 

1.  CALL  "SNDMON"  USING:  Error-Code 

Name-String 
Processing- Code 

Description:  SNDMON  will  provide  the  error 

message  formatting  routine  with  the 
data  needed  to  complete  a  "canned" 
header  (in  this  case,  one  where  the 
destination  is  the  on-host  Monitor 
AP) .  The  formatting  routine  will 
move  the  data  values  to  their  proper 
fields  and  send  the  message.  This 
call  handles  messages  of  Type  31,  32 
and  33.  (See  Appendix  E  for 
formats) . 

Inputs:  Error  Code 

Name-String 

Processing-Code 

2.  CALL  "SNDSAP"  USING:  Error-Code 

Entire  Offending  Message 
Header 

Description:  SNDSAP  will  provide  the  error 

message  formatting  routine  with  the 
data  needed  to  complete  a  "canned" 
header  (in  this  case,  one  where  the 
destination  is  the  source  AP  of  the 
offending  message).  The  formatting 
routine  will  move  the  data  values  to 
their  proper  fields  and  send  the 
message.  This  call  handles  messages 
of  type  32,  33,  and  34. (See  Appendix 
E  for  formats) . 
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Table  E-3  lists  the  errors  identified  for  the  NTM.  Each 
error  is  described  along  with  the  values  for  their  calls  to  the 
error  message 

TABLE  E-3 

ERROR  MESSAGES  DESCRIPTIONS 


Error  Description 


Error 

Code 


Parameters 


Can't  write  to  Mailbox  31001 

Can't  Create  Mailbox  31002 

Can't  Read  Mailbox  31003 

Mailbox  Disconnect  31004 

Error 

Call  Wait  Error  31005 


Processing-Code  =  IPC  Code 

Set  Time  Error  31006 

Mapping  Error  31007 

Job  Process  31008 

Information  Error 

Process  Start  Error  31009 


Data  Length  =  17 
Name-String  =  Mailbox  Name 
Processing-Code  =  IPC  Code 

Data  Length  =  17 
Name-String  =  Mailbox  Name 
Processing-Code  =  IPC  Code 

Data-Length  =  17 
Name-String  =  Mailbox  Name 
Processing-Code  =  IPC  Code 

Data-Length  =  17 
Name-String  =  Mailbox  Name 
Processing-Code  =  IPC  Code 

Data-Length  =  17 
Name-String  =  NTM  Module  Name 
or  AP  Name  if  API  error 


Data-Length  =  17 
Name-String  =  NTM  Module  Name 
Processing-Code  =  IPC  Code 

Data-Length  =  17 
Name-String  =  NTM  Module  Name 
or  AP  Name  if 
API  error 

Processing-Code  =  OS  Code 

Data-Length  =  17 
Name-String  =  NTM  Module  Name 
or  AP  Name  if  API  error 
Processing-Code  =  OS  Code 

Data-Length  =  17 
Name-String  =  Process  Name 
Processing-Code  =  OS  Code 
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ERROR  MESSAGES  DESCRIPTIONS  (Continued) 


Error 

Error  Description _ Code _ Parameters 


Process  Abort  Error 


Process  Not  Found 


File  Read  Error 


File  Write  Error 


File  Close  Error 


File  Open  Error 


Table  Read  Error 


Table  Write  Error 


CDM  Data  Access  Errors 


Message  Arrived  at 
Wrong  APC 


31010  Data-Length  =  17 
Name-String  =  Process  Name 
Processing-Code  =  OS  Code 

31011  Data  Length  =  17 
Name-String  =  Process  Name 
Processing-Code  =  OS  Code 

31012  Data  Length  =  17 
Name-String  =  File  Name 
Processing-Code  =  OS  Code 

31013  Data-Length  =  17 
Name-String  =  File  Name 
Processing-Code  =  OS  Code 

31014  Data-Length  =  17 
Name-String  =  File  Name 
Processing-Code  =  OS  Code 

31015  Data-Length  =  17 
Name-String  =  File  Name 
Processing-Code  =  OS  Code 

31016  Data-Length  =  17 
Name-String  =  Table  Name 
Processing-Code  =  OS  Code 

31017  Data-Length  =  17 
Name-String  =  Table  Name 
Processing-Code  =  OS  Code 

31018  Data-Length  =  17 
Name-String  =  MPU  Name 
Processing-Code  =  Blank 

31019  Data-Length  =  17 
Name-String  =  Sending  MPU 
Processing-Code  =  Blank 
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TABLE  E-3 

ERROR  MESSAGES  DESCRIPTIONS  (Continued) 


Error 

Error  Description _ Code _ Parameters 


OS  Call  Error  31020 

(for  those  not 
or  covered  specifically) 

Time-out  Error  31021 

COBOL  Call  Error  31022 

Exception  Condition  31023 

Entry-Not-Found  31024 

Entry-Not-Deleted  31025 

Invalid  Search  Field  31026 

Cancel  Timeout  Error  31027 

IPC  Error  31028 


Data-Length  =  17 
Name-String  =  MPU  Module  Name 
AP  Name  if  AP  Interface 
Processing-Code  =  OS  Code 

Data-Length  =  17 
Name-String  = 

Processing-Code 

Data-Length  =  17 
Name-String  =  Offending  AP 
Processing -Code 

Data-Length  =  17 
Name-String  =  AP  Having 
Exception  Condition 
Processing  Code 

Data-Length  =  17 
Name-String  =  Table  Name 
Processing-Code  =  Blanks 

Data-Length  =  17 
Name-String  =  Table  Name 
Processing-Code  =  Blanks 

Data-Length  =  17 
Name-String  =  Table  Name 
Processing-Code  =  Blanks 

Data-Length  =  17 
Name-String= 

Processing  Code  = 

Data-Length  =  17 
Name-String  =  Error  Entity 
Processing-Code  =  IPC  Code 


E-96 


DS  620342000 
30  September  1990 


TABLE  E-3 

ERROR  MESSAGES  DESCRIPTIONS  (Continued) 


Error  Description 


Error 

Code  Parameters 


Invalid  Category  in 
Message  Header 


Invalid  Header  Format 


Invalid  Header  Length 


Invalid  Binary/Native 


Invalid  Message  Type 


32001  On  CALL  "SNDMON" 

Data  Length  =  17 
Name-String  =  Process  Name 
Processing-Code  =  OS  Code 
On  CALL  "SNDSAP" 

Offending  Header 

32002  On  CALL  "SNDMON" 

Data  Length  =  17 
Name-String  =  Source  AP 
Processing-Code  =  Blank 
On  CALL  "SNDSAP" 

Offending  Header 

32003  On  CALL  "SNDMON" 

Data-Length  =  17 
Name-String  =  Source  AP 
Processing-Code  =  Blank 
On  CALL  "SNDSAP" 

Offending  Header 

32004  On  CALL  "SNDMON"  Flag 

Data-Length  =  1 
Name-String  =  Source  AP 
Processing-Code  =  Blank 
On  CALL  "SNDSAP" 

Offending  Header 

32005  On  CALL  "SNDMON" 

Data-Length  =  17 
Name-String  =  Source  AP 
Processing-Code  =  Blank 
On  CALL  "SNDSAP" 

Offending  Header 


E-97 


DS  620342000 
30  September  1990 


TABLE  E-3 

ERROR  MESSAGES  DESCRIPTIONS  (Continued) 


Error  Description 


Error 

Code  Parameters 


Invalid  Source  AP 


Invalid  Source 
Instance 


Invalid  Source  APC 
Name 


Invalid  (Header) 
Processing  Code 


Invalid  Continuation 
Flag 


Invalid  Data  Length 


32006  On  CALL  "SNDMON" 

Data-Length  =  0 
Name-String  =  Blank 
Processing-Code  =  Blank 
On  CALL  "SNDSAP" 

N/A 

32007  On  CALL  "SNDMON" 

Data  Length  =  17 
Name-String  =  Source  AP 
Processing-Code  =  Blank 
On  CALL  "SNDSAP" 

N/A 

32008  On  CALL  "SNDMON" 

Data  Length  =  17 
Name-String  =  Source  AP 
Name 

Processing-Code  =  Blank 
On  CALL  "SNDSAP" 

Offending  Header 

32009  On  CALL  "SNDMON" 

Data-Length  =  17 
Name-String  =  Source 
Processing-Code  =  Blank 
On  CALL  "SNDSAP" 

Offending  Header 

32010  On  CALL  "SNDMON" 

Data-Length  =  1 
Name-String  =  Source  AP 
Processing-Code  =  Blank 
On  CALL  "SNDSAP" 

Offending  Header 

32011  On  CALL  "SNDMON" 

Data-Length  =  17 
Name-String  =  Source  AP 
Processing-Code  =  Blank 
On  CALL  "SNDSAP" 

Offending  Header 


E-98 


DS  620342000 
30  September  1990 


TABLE  E-3 

ERROR  MESSAGES  DESCRIPTIONS  (Continued) 


Error 

Error  Description _ Code _ Parameters 

Invalid  Message  Priority  32012  On  CALL  "SNDMON 

Data-Length  =  17 
Name  String  =  Source  AP 
Processing  Code  =  Blank 
On  CALL  "SNDSAP" 

Offending  Header 

33001  On  CALL  "SNDMON" 

Data-Length  =  17 
Name-String  =  Table  Name 
Processing-Code  =  Blank 
On  CALL  "SNDSAP" 

Entire  Header 

No  Authorization  34001  Entire  Header 

Illegal  Message  Type  34002  Entire  Header 

Invalid  Destination  34003  Entire  Header 


Resource  Unavailable 
-or- 
Table  Full 
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